CM_Get_Class_Property_Keys function
The CM_Get_Class_Property_Keys function retrieves an array of the device property keys that represent the device properties that are set for a device interface class or device setup class.
Syntax
CMAPI CONFIGRET WINAPI CM_Get_Class_Property_Keys( _In_ LPCGUID ClassGUID, _Out_opt_ DEVPROPKEY *PropertyKeyArray, _Inout_ PULONG PropertyKeyCount, _In_ ULONG ulFlags );
Parameters
- ClassGUID [in]
-
Pointer to the GUID that identifies the device interface class or device setup class for which to retrieve the property keys for. For information about specifying the class type, see the ulFlags parameter.
- PropertyKeyArray [out, optional]
-
Pointer to a buffer that receives an array of DEVPROPKEY-typed values, where each value is a device property key that represents a device property that is set for the device class. The pointer is optional and can be NULL.
- PropertyKeyCount [in, out]
-
The size, in DEVPROPKEY-typed units, of the PropertyKeyArray buffer. If PropertyKeyArray is set to NULL, *PropertyKeyCount must be set to zero. As output, if PropertyKeyArray is not large enough to hold all the property key data, CM_Get_Class_Property_Keys returns the count of the keys, in *PropertyKeyCount.
- ulFlags [in]
-
Class property key flags:
Return value
If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.
Remarks
CM_Get_Class_Property_Keys is part of the Unified Device Property Model.
Requirements
|
Target platform | |
|---|---|
|
Version |
Available in Microsoft Windows Vista and later versions of Windows. |
|
Header |
|
|
Library |
|
|
DLL |
|
See also