CM_Get_DevNode_Property_Keys函式 (cfgmgr32.h)

CM_Get_DevNode_Property_Keys函式會擷取裝置屬性索引鍵的陣列，這些索引鍵代表為裝置實例設定的裝置屬性。

語法

CMAPI CONFIGRET CM_Get_DevNode_Property_Keys(
  [in]            DEVINST    dnDevInst,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

參數

[in] dnDevInst

系結至本機計算機的裝置實例句柄。

[out, optional] PropertyKeyArray

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

[in, out] PropertyKeyCount

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

[in] ulFlags

保留的。 必須設定為零。

傳回值

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

備註

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

規格需求

另請參閱

SetupDiGetDevicePropertyKeys