DmiAddGroup(3dmi)
DmiAddGroup --
add group to component in DMI database
Synopsis
cc [options] file -llibdmionc # remote calls
cc [options] file -llibdmi2api # local calls
#include <dmi2srv.h>
DmiErrorStatus_t DMI_API DmiAddGroup (
DmiHandle_t handle,
DmiFileDataList_t * fileData,
DmiId_t compId,
DmiId_t groupId,
DmiStringList_t ** errors );
Description
The DmiAddGroup function is used to add a new group to an
existing component in the database. It takes the name of a file,
or the address of memory block containing the group's schema
description data, checks the data for adherence to the schema
description grammar (e.g. DMI MIF grammar), and installs the
group schema description in the database.
Parameters
handle-
(Input)
An open session handle
fileData-
(Input)
Schema description file data for the group definition
compId-
(Input)
Component to access
groupId-
(Output)
On completion, the SP-allocated group ID
errors-
(Output)
Installation error messages
Return values
DMIERR_ILLEGAL_HANDLE-
DMIERR_OUT_OF_MEMORY-
DMIERR_INSUFFICIENT_PRIVILEGES-
DMIERR_SP_INACTIVE-
DMIERR_COMPONENT_NOT_FOUND-
DMIERR_DATABASE_CORRUPT-
DMIERR_FILE_ERROR-
DMIERR_BAD_SCHEMA_DESCRIPTION_FILE-
DMIERR_INVALID_FILE_TYPE-
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