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。

注意從 Windows 8 和 Windows Server 2012 開始，不支援使用此函式來存取遠端電腦，因為已移除此功能。

 

傳回值

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

備註

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

規格需求

需求	值
最低支援的用戶端	可在 Microsoft Windows 10 及更新版本的 Windows 中使用。
目標平台	桌面
標頭	cfgmgr32.h (包含 Cfgmgr32.h)
程式庫	Cfgmgr32.lib

另請參閱

CM_Connect_Machine

SetupDiGetDeviceInterfacePropertyKeys