DmiSetMultiple(3dmi)


DmiSetMultiple -- perform set operation on one or more attributes

Synopsis

cc [options] file -llibdmionc # remote calls
cc [options] file -llibdmi2api # local calls

#include <dmi2srv.h>

DmiSetMultiple ( DmiHandle_t handle, DmiSetMode_t setMode, DmiMultiRowData_t * rowData );

Description

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 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.

Parameters


handle
(Input) An open session handle

setMode
(Input) Set, reserve, or release

rowData
(Input) Attribute values 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_VALUE_EXCEEDS_MAXSIZE

DMIERR_COMPONENT_NOT_FOUND

DMIERR_GROUP_NOT_FOUND

DMIERR_ILLEGAL_KEYS

DMIERR_ILLEGAL_TO_SET

DMIERR_OVERLAY_NAME_NOT_FOUND

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