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 包含用于访问远程系统的 ConfigMgr32 系统句柄和 DeviceInfoSetDetailData。RemoteMachineName 包含远程系统的名称。 如果设备信息集有远程句柄,则必须在调用 CM_Xxx_Ex 函数时使用该远程句柄,因为 DevInst 句柄相对于远程句柄。
如果设备信息集适用于本地计算机,则 DeviceInfoSetDetailData。RemoteMachineHandle 为 NULL,DeviceInfoSetDetailData。RemoteMachineName 是一个空字符串。
注意
setupapi.h 标头将 SetupDiGetDeviceInfoListDetail 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | setupapi.h (包括 Setupapi.h) |
Library | Setupapi.lib |