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
Requirement | Value |
---|---|
Minimum supported client | Available in Microsoft Windows 10 and later versions of Windows. |
Target Platform | Desktop |
Header | cfgmgr32.h (include Cfgmgr32.h) |
Library | Cfgmgr32.lib |