SetupDiGetDeviceInfoListDetailA 函式 (setupapi.h)

SetupDiGetDeviceInfoListDetail 函式會擷取與裝置資訊集相關聯的資訊，包括 GUID 類別、遠端電腦句柄和遠端電腦名稱。

語法

WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
  [in]  HDEVINFO                       DeviceInfoSet,
  [out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);

參數

[in] DeviceInfoSet

要擷取資訊的 裝置資訊集 句柄。

[out] DeviceInfoSetDetailData

呼叫端初始化 SP_DEVINFO_LIST_DETAIL_DATA 結構的指標，可接收裝置資訊集資訊。 如需此結構的詳細資訊，請參閱下列一節。

傳回值

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

備註

如果參數有效， SetupDiGetDeviceInfoListDetail會在 DeviceInfoSetDetailData 結構中設定值 (，但 cbSize 字段) 除外，並傳回狀態NO_ERROR。

SetupDiGetDeviceInfoListDetail 的呼叫端必須設定 DeviceInfoSetDetailData。cbSize 為 sizeof (SP_DEVINFO_LIST_DETAIL_DATA) 或函式將會失敗，而 GetLastError 的呼叫會傳回ERROR_INVALID_USER_BUFFER。

如果 SetupDiGetDeviceInfoListDetail 成功完成， DeviceInfoSetDetailData。ClassGuid 包含與裝置資訊集或GUID_NULL結構相關聯的類別 GUID。

如果 SetupDiGetDeviceInfoListDetail 順利完成，且裝置資訊集適用於遠端系統 DeviceInfoSetDetailData。RemoteMachineHandle 包含用來存取遠端系統和 DeviceInfoSetDetailData 的 ConfigMgr32 系統句柄。RemoteMachineName 包含遠端系統的名稱。 如果裝置資訊集有遠端句柄，則必須在呼叫 CM_Xxx_Ex 函式時使用，因為 DevInst 句柄相對於遠端句柄。

如果裝置資訊集是針對本機計算機， DeviceInfoSetDetailData。RemoteMachineHandle 為 NULL 且 DeviceInfoSetDetailData。RemoteMachineName 是空字串。

注意

setupapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetupDiGetDeviceInfoListDetail 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass