DmiGetAttribute(3dmi)
DmiGetAttribute --
get single attribute value from Service Provider
Synopsis
cc [options] file -llibdmionc # remote calls
cc [options] file -llibdmi2api # local calls
#include <dmi2srv.h>
DmiErrorStatus_t DMI_API DmiGetAttribute (
DmiHandle_t handle,
DmiId_t compId,
DmiId_t groupId,
DmiId_t attribId,
DmiAttributeValues_t * keyList,
DmiDataUnion_t ** value );
Description
The DmiGetAttribute function provides a simple method for retrieving
a single attribute value from the DMI Service Provider. The compId,
groupId, attribId, and keyList identify the desired attribute. The
resulting attribute value is returned in a newly allocated DmiDataUnion
structure. The address of this structure is returned through 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
value-
(Output)
Attribute value returned
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