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来检索记录的错误。

言论

如果参数有效,SetupDiGetDeviceInfoListDetailDeviceInfoSetDetailData 结构(cbSize 字段除外)中设置值,并返回状态NO_ERROR。

SetupDiGetDeviceInfoListDetail 的调用方必须设置 DeviceInfoSetDetailData。cbSizesizeof(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。RemoteMachineHandleNULLDeviceInfoSetDetailData。RemoteMachineName 为空字符串。

注意

setupapi.h 标头将 SetupDiGetDeviceInfoListDetail 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Setupapi.lib

另请参阅

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass