DmiListClassNames(3dmi)

DmiListClassNames -- list class names of all groups in a component

Synopsis

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

#include <dmi2srv.h>

DmiErrorStatus_t DMI_API DmiListClassNames (
		DmiHandle_t		handle,
		DmiUnsigned_t		maxCount,
		DmiId_t			compId,
		DmiClassNameList_t **	reply );

Description

The DmiListClassNames function retrieves the class name strings for all groups in a component. This allows the management application to easily determine if a component contains a specific group, or groups. The maxCount parameter limits the number of class name strings returned to the caller.

Parameters

handle: (Input) An open session handle
maxCount: (Input) Maximum number to return, or zero for all
compId: (Input) Component to access
reply: (Output) List of class names and group ids

Return values

DMIERR_NO_ERROR
DMIERR_ILLEGAL_HANDLE
DMIERR_OUT_OF_MEMORY
DMIERR_INSUFFICIENT_PRIVILEGES
DMIERR_SP_INACTIVE
DMIERR_COMPONENT_NOT_FOUND
DMIERR_DATABASE_CORRUPT
DMIERR_FILE_ERROR

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.