CM_Get_Class_Property_Keys_Ex函式 (cfgmgr32.h)

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

CM_Get_Class_Property_Keys_Ex函式會擷取裝置屬性索引鍵的數位，這些索引鍵代表針對裝置介面類別或裝置設定類別所設定的裝置屬性。

語法

CMAPI CONFIGRET CM_Get_Class_Property_Keys_Ex(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

參數

[in] ClassGUID

識別要為其擷取屬性索引鍵之 裝置介面類別 或 裝置安裝類別 的 GUID 指標。 如需指定類別類型的相關信息，請參閱 ulFlags 參數。

[out, optional] PropertyKeyArray

接收 DEVPROPKEY 類型值數位的緩衝區指標，其中每個值都是裝置屬性索引鍵，代表為裝置類別設定的裝置屬性。 指標是選擇性的，而且可以是 NULL。

[in, out] PropertyKeyCount

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

[in] ulFlags

類別屬性索引鍵旗標：

CM_CLASS_PROPERTY_INSTALLER

ClassGUID 會指定裝置安裝類別。 請勿與CM_CLASS_PROPERTY_INTERFACE結合。

CM_CLASS_PROPERTY_INTERFACE

ClassGUID 指定裝置介面類別。 請勿與CM_CLASS_PROPERTY_INSTALLER結合。

[in, optional] hMachine

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

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

 

傳回值

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

備註

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

規格需求

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

另請參閱

CM_Connect_Machine

SetupDiGetClassPropertyKeys

SetupDiGetClassPropertyKeysEx