IUPnPDescriptionDocument::Load-Methode (upnp.h)

Die Load-Methode lädt ein Dokument synchron. Diese Methode gibt erst die Steuerung an den Aufrufer zurück, wenn der Ladevorgang abgeschlossen ist.

Syntax

HRESULT Load(
  [in] BSTR bstrUrl
);

Parameter

[in] bstrUrl

Gibt die URL des zu ladenden Dokuments an.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes oder einen der folgenden UPnP-Rückgabewerte zurück.

Rückgabecode	Beschreibung
UPNP_E_DEVICE_ELEMENT_EXPECTED	Das XML-Dokument verfügt über kein Geräteelement. Es fehlt entweder im Stammelement oder im DeviceList-Element.
UPnP_E_DEVICE_ELEMENT_EXPECTED	Im angegebenen Beschreibungsdokument ist kein Device-Element vorhanden.
UPNP_E_DEVICE_NODE_INCOMPLETE	Im XML-Dokument fehlt eines der erforderlichen Elemente im Device-Element.
UPNP_E_ICON_ELEMENT_EXPECTED	Ein XML-Dokument verfügt nicht über ein Symbolelement. Es fehlt im IconList-Element, oder das DeviceList-Element enthält kein IconList-Element.
UPnP_E_ICON_ELEMENT_EXPECTED	Das angegebene Beschreibungsdokument enthält kein Icon-Element.
UPNP_E_ICON_NODE_INCOMPLETE	Im XML-Dokument fehlt eines der erforderlichen Elemente im Icon-Element.
UPnP_E_ICON_NODE_INCOMPLETE	Im angegebenen Beschreibungsdokument ist kein Symbolknoten vorhanden.
UPNP_E_ROOT_ELEMENT_EXPECTED	Das XML-Dokument verfügt nicht über ein Stammelement auf der obersten Ebene des Dokuments.
UPnP_E_ROOT_ELEMENT_EXPECTED	Im angegebenen Beschreibungsdokument ist kein Root-Element vorhanden.
UPNP_E_SERVICE_ELEMENT_EXPECTED	Das XML-Dokument verfügt über kein Dienstelement. Es fehlt im ServiceList-Element, oder das DeviceList-Element enthält kein ServiceList-Element.
UPNP_E_SERVICE_NODE_INCOMPLETE	Im XML-Dokument fehlt eines der erforderlichen Elemente im Service-Element.

Hinweise

Diese Methode sollte nicht über einen Benutzeroberflächenthread aufgerufen werden, da es lange dauern kann, bis die Methode zurückgegeben wird.

Wenn die Load-Methode von einem Skript innerhalb einer Webseite aufgerufen wird, kann bstrUrl eine relative URL sein. Die Adresse der aktuellen Webseite wird als Basis-URL verwendet.

Wenn diese Methode von einer Webseite aus aufgerufen wird, muss die vom Aufrufer festgelegte URL auf denselben Server verweisen, von dem die Webseite geladen wurde.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	upnp.h
DLL	Upnp.dll

Weitere Informationen

IUPnPDescriptionDocument

IUPnPDescriptionDocument::LoadAsync