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

Target platform

Universal

Version

Available in Microsoft Windows Vista and later versions of Windows.

Header

Cfgmgr32.h (include Cfgmgr32.h)

Library

Cfgmgr32.lib;
OneCoreUAP.lib on Windows 10 Technical Preview

DLL

CfgMgr32.dll

See also

SetupDiGetDevicePropertyKeys

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft