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.