Description

The operation functions provide a method for retrieving a single value
from the Service Provider and for setting a single attribute value.
In addition, you may also retrieve attribute values from the Service Provider.
You may perform a set operation on an attribute or
a list of attributes and add or delete a row from an
existing table.

The DmiAddRow() function adds a row to an existing table. The rowData
parameter contains the full data, including key attribute values, for a
row. It is an error for the key list to specify an
existing table row. The argin parameter is an instance of a DmiAddRowIN
structure containing the following members:

The result parameter is a pointer to a DmiAddRowOUT structure containing the
following members:

DmiErrorStatus_t error_status;

DmiDeleteRow() function removes a row from an existing table. The key
list must specify valid keys for a table row. The argin parameter
is an instance of a DmiDeleteRowIN structure containing the following members:

The result parameter is a pointer to a DmiDeleteRowOUT structure containing the
following members:

DmiErrorStatus_t error_status;

The DmiGetAttribute() function provides a simple method for retrieving a single attribute
value from the 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. The argin parameter is an instance of a
DmiListComponentsIN structure containing the following members:

The DmiGetMultiple() function retrieves attribute values from the Service Provider. This
procedure may get the value for an individual attribute, or for
multiple attributes across groups, components, or rows of a table.

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. The argin
parameter is an instance of a DmiSetAttributeIN structure containing the following members:

The result parameter is a pointer to a DmiSetAttributeOUT structure containing the
following members:

DmiErrorStatus_t error_status;

The DmiSetMultiple() function performs a set operation on an attribute or list
of attributes. Set operations include actually setting the value, testing and
reserving the attribute for future setting, or releasing the set reserve.
These variations on the set operation are specified by the parameter
setMode. The argin parameter is an instance of a DmiSetMultipleIN structure containing the
following members:

The result parameter is a pointer to a DmiSetMultipleOUT structure containing the
following members:

DmiErrorStatus_t error_status;

The rowData array describes the attributes to set, and contains the
new attribute values. Each element of rowData specifies a component, group,
key list (for table accesses), and attribute list to set. No data
is returned from this function.