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