CM_Get_Device_Interface_Property_Keys_ExW函式 (cfgmgr32.h)

[從 Windows 8 和 Windows Server 2012 開始，此函式已被取代。 請改用 CM_Get_Device_Interface_Property_Keys 。]

CM_Get_Device_Interface_Property_Keys_ExW函式會擷取代表裝置介面所設定之裝置屬性的裝置屬性索引鍵陣列。

語法

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
);

參數

[in] pszDeviceInterface

字串的指標，識別要從中擷取屬性索引鍵的裝置介面實例。

[out, optional] PropertyKeyArray

緩衝區的指標，該緩衝區會接收 DEVPROPKEY 類型的值陣列，其中每個值都是代表裝置介面所設定之裝置屬性的裝置屬性索引鍵。 指標是選擇性的，可以是 NULL

[in, out] PropertyKeyCount

PropertyKeyArray 緩衝區的 DEVPROPKEY 類型單位大小。 如果 PropertyKeyArray 設定為 NULL， *PropertyKeyCount 必須設定為零。 輸出時，如果 PropertyKeyArray 不足以保存所有屬性索引鍵數據， CM_Get_Device_Interface_Property_Keys_ExW 會在 *PropertyKeyCount 中傳回索引鍵的計數。

[in] ulFlags

保留的。 必須設定為零。

[in, optional] hMachine

呼叫端提供的機器句柄，是從先前呼叫取得 來CM_Connect_Machine。

傳回值

如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

CM_Get_Device_Interface_Property_Keys_ExW 是 整合裝置屬性模型的一部分。

規格需求

另請參閱

CM_Connect_Machine

SetupDiGetDeviceInterfacePropertyKeys