IUPnPDescriptionDocument：：Load 方法 (upnp.h)

Load 方法同步加载文档。在加载操作完成之前，此方法不会将控制权返回给调用方。

语法

HRESULT Load(
  [in] BSTR bstrUrl
);

[in] bstrUrl

指定要加载的文档的 URL。

如果该方法成功，则返回值S_OK。否则，该方法返回 WinError.h 中定义的 COM 错误代码之一或以下 UPnP 返回值之一。

返回代码	说明
UPNP_E_DEVICE_ELEMENT_EXPECTED	XML 文档没有 device 元素。根元素或 DeviceList 元素中缺少它。
UPnP_E_DEVICE_ELEMENT_EXPECTED	指定的说明文档中没有 Device 元素。
UPNP_E_DEVICE_NODE_INCOMPLETE	XML 文档缺少 Device 元素中必需的元素之一。
UPNP_E_ICON_ELEMENT_EXPECTED	XML 文档没有图标元素。 IconList 元素中缺少它，或者 DeviceList 元素不包含 IconList 元素。
UPnP_E_ICON_ELEMENT_EXPECTED	指定的说明文档中没有 Icon 元素。
UPNP_E_ICON_NODE_INCOMPLETE	XML 文档缺少 Icon 元素中必需的元素之一。
UPnP_E_ICON_NODE_INCOMPLETE	指定的说明文档中没有图标节点。
UPNP_E_ROOT_ELEMENT_EXPECTED	XML 文档在文档的顶层没有根元素。
UPnP_E_ROOT_ELEMENT_EXPECTED	指定的说明文档中没有 Root 元素。
UPNP_E_SERVICE_ELEMENT_EXPECTED	XML 文档没有 service 元素。 ServiceList 元素中缺少它，或者 DeviceList 元素不包含 ServiceList 元素。
UPNP_E_SERVICE_NODE_INCOMPLETE	XML 文档缺少 Service 元素中的必需元素之一。

不应从用户界面线程调用此方法，因为此方法可能需要很长时间才能返回。

如果 Load 方法由网页中的脚本调用， 则 bstrUrl 可能是相对 URL。当前网页的地址用作基 URL。

如果从网页调用此方法，则调用方指定的 URL 必须引用从中加载网页的同一服务器。