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 |