CM_Get_Device_Interface_Property_Keys_ExW function (cfgmgr32.h)

[Beginning with Windows 8 and Windows Server 2012, this function has been deprecated. Please use CM_Get_Device_Interface_Property_Keys instead.]

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

Syntax

CMAPI CONFIGRET CM_Get_Device_Interface_Property_Keys_ExW(
  [in]            LPCWSTR    pszDeviceInterface,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parameters

[in] pszDeviceInterface

Pointer to a string that identifies the device interface instance to retrieve the property keys from.

[out, optional] PropertyKeyArray

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 interface. The pointer is optional and can be NULL

[in, out] PropertyKeyCount

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

[in] ulFlags

Reserved. Must be set to zero.

[in, optional] hMachine

Caller-supplied machine handle, obtained from a previous call to CM_Connect_Machine.

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_Device_Interface_Property_Keys_ExW is part of the Unified Device Property Model.

Requirements

See also

CM_Connect_Machine

SetupDiGetDeviceInterfacePropertyKeys