SetupDiGetDeviceInfoListClass 函式 (setupapi.h)

  • 發行項

如果集合具有相關聯的類別， SetupDiGetDeviceInfoListClass 函式會擷取與裝置資訊集相關聯 之裝置安裝類別 的 GUID。

語法

WINSETUPAPI BOOL SetupDiGetDeviceInfoListClass(
  [in]  HDEVINFO DeviceInfoSet,
  [out] LPGUID   ClassGuid
);

參數

[in] DeviceInfoSet

設定為查詢 之裝置資訊的 句柄。

[out] ClassGuid

GUID 類型的變數指標，可接收相關聯類別的 GUID。

傳回值

如果函式成功，函式會傳回 TRUE 。 否則，它會傳回 FALSE ，而且可以透過呼叫 GetLastError 來擷取記錄的錯誤。

備註

如果指定的裝置資訊集沒有相關聯的類別，因為使用 SetupDiCreateDCreateDeviceInfoList 建立集合時未指定類別 GUID，則函式會失敗。 在此情況下， 對 GetLastError 的呼叫會傳回ERROR_NO_ASSOCIATED_CLASS。

如果裝置資訊集適用於遠端電腦，請使用 SetupDiGetDeviceInfoListDetail 來取得相關聯的遠端電腦句柄和電腦名稱。

規格需求

需求 值
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 setupapi.h (包括 Setupapi.h)
程式庫 Setupapi.lib
Dll Setupapi.dll

另請參閱

SetupDiCreateDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListDetail