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::LoadIUPnPDescriptionDocument::LoadAsync 加载设备说明后,使用 DeviceByUDNIUPnPDescriptionDocument::ReadyState 属性返回READYSTATE_COMPLETED。

请勿使用 DeviceByUDN ,除非首先使用 IUPnPDescriptionDocument::LoadIUPnPDescriptionDocument::LoadAsync 加载设备说明。 搜索操作仅在当前加载的设备说明中搜索。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 upnp.h
DLL Upnp.dll

另请参阅

IUPnPDescriptionDocument

IUPnPDevice