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.