DmiSetAttribute(3dmi)
DmiSetAttribute --
set a single attribute value
Synopsis
cc [options] file -llibdmionc # remote calls
cc [options] file -llibdmi2api # local calls
#include <dmi2srv.h>
DmiErrorStatus_t DMI_API DmiSetAttribute (
DmiHandle_t handle,
DmiId_t compId,
DmiId_t groupId,
DmiId_t attribId,
DmiAttributeValues_t * keyList,
DmiSetMode_t setMode,
DmiDataUnion_t * value );
Description
The DmiSetAttribute function provides a simple method for setting a
single attribute value. The compId, groupId, attribId,
and keyList
identify the desired attribute; the setMode parameter defines the
procedure call as a Set, Reserve, or Release operation. The new
attribute value is contained in the DmiDataUnion structure whose
address is passed in the value parameter.
Parameters
handle-
(Input)
An open session handle
compId-
(Input)
Component to access
groupId-
(Input)
Group within component
attribId-
(Input)
Attribute within group
keyList-
(Input)
Keylist to specify a table row
setMode-
(Input)
Set, reserve, or release ?
value-
(Input)
Attribute value to set
Return values
DMIERR_NO_ERROR-
DMIERR_ILLEGAL_HANDLE-
DMIERR_OUT_OF_MEMORY-
DMIERR_INSUFFICIENT_PRIVILEGES-
DMIERR_SP_INACTIVE-
DMIERR_ATTRIBUTE_NOT_FOUND-
DMIERR_COMPONENT_NOT_FOUND-
DMIERR_GROUP_NOT_FOUND-
DMIERR_ILLEGAL_KEYS-
DMIERR_OVERLAY_NAME_NOT_FOUND-
DMIERR_ILLEGAL_TO_GET-
DMIERR_ROW_NOT_FOUND-
DMIERR_DIRECT_INTERFACE_NOT_REGISTERED -
DMIERR_DATABASE_CORRUPT-
DMIERR_ATTRIBUTE_NOT_SUPPORTED-
DMIERR_UNKNOWN_CI_REGISTRY-
DMIERR_FILE_ERROR-
DMIERR_OVERLAY_NOT_FOUND-
DMIERR_VALUE_UNKNOWN-
For a description of return values, see
``DMI error codes'' in Desktop Management Interface programming.
Notices
Portions of this page are derived from material for which the
copyright owner is the Desktop Management Task Force. The
material is reprinted with permission. See copyright page for a full
statement of rights and permissions.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004