IUPnPDescriptionDocument::D eviceByUDN 方法 (upnp.h)
DeviceByUDN 方法返回具有指定唯一设备名称的设备, (UDN) 包含在加载的说明文档中。
语法
HRESULT DeviceByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **ppudDevice
);
参数
[in] bstrUDN
指定设备的 UDN。
[out] ppudDevice
接收对描述设备的 IUPnPDevice 对象的引用。 此引用在不再使用时必须释放。
返回值
如果方法成功,则返回值S_OK。 否则,方法将返回 WinError.h 中定义的 COM 错误代码之一。
注解
使用 IUPnPDescriptionDocument::Load 或 IUPnPDescriptionDocument::LoadAsync 加载设备说明后,使用 DeviceByUDN。 IUPnPDescriptionDocument::ReadyState 属性返回READYSTATE_COMPLETED。
请勿使用 DeviceByUDN ,除非首先使用 IUPnPDescriptionDocument::Load 或 IUPnPDescriptionDocument::LoadAsync 加载设备说明。 搜索操作仅在当前加载的设备说明中搜索。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | upnp.h |
DLL | Upnp.dll |