DmiGetMultiple(3dmi)
DmiGetMultiple --
get attribute values from DMI Service Provider
Synopsis
cc [options] file -llibdmionc # remote calls
cc [options] file -llibdmi2api # local calls
#include <dmi2srv.h>
DmiErrorStatus_t DMI_API DmiGetMultiple (
DmiHandle_t handle,
DmiMultiRowRequest_t * request,
DmiMultiRowData_t ** rowData );
Description
The DmiGetMultiple function retrieves attribute values from the
DMI Service Provider. This command may get the value for an
individual attribute, or for multiple attributes across groups,
components, or rows of a table.
The request array
specifies the attribute values requested by the management application.
Each element of the array specifies a component, group, request mode,
key list (for table accesses), and attribute list to retrieve.
The key list is omitted (NULL pointer value) for scalar groups. If
the attribute list is omitted, the service provider returns all
attributes in the group or table row. The requestMode specifier allows
the management application to request the first, next, or specific
attribute value.
The rowData array
contains the reply from the DMI Service Provider. The structure
of this reply is identical to that of the original request, with the
same number of elements that were in the request array.
Parameters
handle-
(Input)
An open session handle
request-
(Input)
Attributes to get
rowData-
(Output)
Requested attribute values
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