Поделиться через

Метод IUPnPDescriptionDocument::Load (upnp.h)

  • Статья

Метод Load загружает документ синхронно. Этот метод не возвращает управление вызывающей объекту до завершения операции загрузки.

Синтаксис

HRESULT Load(
  [in] BSTR bstrUrl
);

Параметры

[in] bstrUrl

Указывает URL-адрес загружаемого документа.

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h, или одно из следующих возвращаемых значений UPnP.

Код возврата Описание
UPNP_E_DEVICE_ELEMENT_EXPECTED
 XML-документ не содержит элемент устройства. Он отсутствует в корневом элементе или элементе DeviceList.
UPnP_E_DEVICE_ELEMENT_EXPECTED
 В указанном документе описания нет элемента Device.
UPNP_E_DEVICE_NODE_INCOMPLETE
 В XML-документе отсутствует один из обязательных элементов элемента Device.
UPNP_E_ICON_ELEMENT_EXPECTED
 XML-документ не содержит элемента icon. Он отсутствует в элементе 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-документ не содержит элемент службы. Он отсутствует в элементе ServiceList или элемент DeviceList не содержит элемент ServiceList.
UPNP_E_SERVICE_NODE_INCOMPLETE
 В XML-документе отсутствует один из обязательных элементов из элемента Service.

Комментарии

Этот метод не следует вызывать из потока пользовательского интерфейса, так как возврат метода может занять много времени.

Если метод Load вызывается скриптом на веб-странице, bstrUrl может быть относительным URL-адресом. В качестве базового URL-адреса используется адрес текущей веб-страницы.

Если этот метод вызывается из веб-страницы, URL-адрес, который указывает вызывающий объект, должен ссылаться на тот же сервер, с которого была загружена веб-страница.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header upnp.h
DLL Upnp.dll

См. также раздел

IUPnPDescriptionDocument

IUPnPDescriptionDocument::LoadAsync