Export (0) Print
Expand All
Expand Minimize

CM_Get_DevNode_Property_Keys function

The CM_Get_DevNode_Property_Keys function retrieves an array of the device property keys that represent the device properties that are set for a device instance.

Syntax


CMAPI
CONFIGRET
WINAPI CM_Get_DevNode_Property_Keys(
  _In_       DEVINST dnDevInst,
  _Out_opt_  DEVPROPKEY *PropertyKeyArray,
  _Inout_    PULONG PropertyKeyCount,
  _In_       ULONG ulFlags
);

Parameters

dnDevInst [in]

Device instance handle that is bound to the local machine.

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 instance. 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_DevNode_Property_Keys returns the count of the keys in *PropertyKeyCount.

ulFlags [in]

Reserved. Must be set to zero.

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

This function is reserved for system use. Do not use this function in your class installers, co-installers, or device installation applications. Use SetupDiGetDevicePropertyKeys instead.

CM_Get_DevNode_Property_Keys is part of the Unified Device Property Model.

Requirements

Version

Available in Microsoft Windows Vista and later versions of Windows.

Header

Cfgmgr32.h (include Cfgmgr32.h)

Library

Cfgmgr32.lib

See also

SetupDiGetDevicePropertyKeys

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft