The database administration functions add a new component to the database or add a new language mapping for an existing component. You may also remove an existing component, remove a specific language
mapping, or remove a group from a component.
The DmiAddComponent() function adds a new component to the DMI database. It takes the name of a file, or the address of memory block containing MIF data, checks the data for adherence
to the DMI MIF grammar, and installs the MIF in the database. The procedure returns a unique component ID for the newly installed component. The argin parameter is an instance of
a DmiAddComponentIN structure containing the following members:
|
DmiHandle_t handle; /* an open session handle */
DmiFileDataList_t *fileData; /* MIF data for component */
|
The result parameter is a pointer to a DmiAddComponentOUT structure containing the following members:
|
DmiErrorStatus_t error_status;
DmiId_t compId; /* SP-allocated component ID */
DmiStringList_t *errors; /* installation error messages */
|
The DmiAddLanguage() function adds a new language mapping for an existing component in the database. It takes the name of a file, or the address of memory block containing translated
MIF data, checks the data for adherence to the DMI MIF grammar, and installs the language MIF in the database. The argin parameter is an instance of a DmiAddLanguageIN
structure containing the following members:
|
DmiHandle_t handle; /* an open session handle */
DmiFileDataList_t *fileData; /* language mapping file */
DmiId_t compId; /* component to access */
|
The result parameter is a pointer to a DmiAddLanguageOUT structure containing the following members:
|
DmiErrorStatus_t error_status;
DmiStringList_t *errors; /* installation error messages */
|
The DmiAddGroup() function adds 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 MIF data,
checks the data for adherence to the DMI MIF grammar, and installs the group MIF in the database. The argin parameter is an instance of a DmiAddGroupIN structure
containing the following members:
|
DmiHandle_t handle; /* an open session handle */
DmiFileDataList_t *fileData; /* MIF file data for group */
DmiId_t compId; /* component to access */
|
The result parameter is a pointer to a DmiAddGroupOUT structure containing the following members:
|
DmiErrorStatus_t error_status;
DmiId_t groupId; /* SP-allocated group ID */
DmiStringList_t *errors; /* installation error messages */
|
The DmiDeleteComponent() function removes an existing component from the database. The argin parameter is an instance of a DmiDeleteComponentIN
structure containing the following members:
|
DmiHandle_t handle; /* an open session handle */
DmiId_t compId; /* component to delete */
|
The result parameter is a pointer to a DmiDeleteComponentOUT structure containing the following members:
|
DmiErrorStatus_t error_status;
|
The DmiDeleteLanguage() function removes a specific language mapping for a component. You specify the language string and component ID. The argin parameter
is an instance of a DmiDeleteLanguageIN structure containing the following members:
|
DmiHandle_t handle; /* an open session handle */
DmiString_t *language; /* language to delete */
DmiId_t compId; /* component to access */
|
The result parameter is a pointer to a DmiDeleteLanguageOUT structure containing the following members:
|
DmiErrorStatus_t error_status;
|
The DmiDeleteGroup() function removes a group from a component. The caller specifies the component and group IDs. The argin parameter is an instance of a DmiDeleteGroupIN structure containing the following members:
|
DmiHandle_t handle; /* an open session handle */
DmiId_t compId; /* component containing group */
DmiId_t groupId; /* group to delete */
|
The result parameter is a pointer to a DmiDeleteGroupOUT structure containing the following members:
|
DmiErrorStatus_t error_status;
|
|