DmiAddComponent(3dmi)


DmiAddComponent -- add component to DMI database

Synopsis

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

#include <dmi2srv.h>

DmiErrorStatus_t DMI_API DmiAddComponent( DmiHandle_t handle, DmiFileDataList_t * fileData, DmiId_t * compId, DmiStringList_t ** errors );

Description

The DmiAddComponent function is used to add a new component to the DMI database. It takes the name of a file, or the address of memory block containing schema description data, checks the data for adherence to the appropriate schema description format (for example DMI MIF format), and installs the schema description in the database. The procedure returns a unique component ID for the newly installed component.

Parameters


handle
(Input) An open session handle

fileData
(Input) Schema description file data for the component

compId
(Output) On completion, the SP-allocated component ID

errors
(Output) Installation error messages

Return values


DMIERR_NO_ERROR

DMIERR_ILLEGAL_HANDLE

DMIERR_OUT_OF_MEMORY

DMIERR_INSUFFICIENT_PRIVILEGES

DMIERR_SP_INACTIVE

DMIERR_DATABASE_CORRUPT

DMIERR_INSUFFICIENT_PRIVILEGES

DMIERR_FILE_ERROR

DMIERR_BAD_SCHEMA_DESCRIPTION_FILE

DMIERR_INVALID_FILE_TYPE

DMIERR_FILE_TYPE_NOT_SUPPORTED

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