共用方式為

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 結構 中設定值 ，並傳回狀態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 包含 ConfigMgr32 系統句柄，用於存取遠端系統和 DeviceInfoSetDetailData。RemoteMachineName 包含遠端系統的名稱。 如果裝置資訊集有遠端句柄，則必須在呼叫 CM_Xxx_Ex 函式時使用，因為 DevInst 句柄相對於遠端句柄。

如果裝置資訊集是針對本機計算機，DeviceInfoSetDetailData。RemoteMachineHandleNULL 和 DeviceInfoSetDetailData。RemoteMachineName 是空字串。

注意

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

要求

要求 價值
最低支援的用戶端 Microsoft Windows 2000 和更新版本的 Windows 中提供。
目標平臺 桌面
標頭 setupapi.h （包括 Setupapi.h）
連結庫 Setupapi.lib

另請參閱

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass