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.