Méthode IUPnPDescriptionDocument::Load (upnp.h)

Article
08/26/2023

La méthode Load charge un document de manière synchrone. Cette méthode ne retourne pas le contrôle à l’appelant tant que l’opération de chargement n’est pas terminée.

Syntaxe

HRESULT Load(
  [in] BSTR bstrUrl
);

Paramètres

[in] bstrUrl

Spécifie l’URL du document à charger.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h ou l’une des valeurs de retour UPnP suivantes.

Code de retour	Description
UPNP_E_DEVICE_ELEMENT_EXPECTED	Le document XML n’a pas d’élément d’appareil. Il manque l’élément racine ou l’élément DeviceList.
UPnP_E_DEVICE_ELEMENT_EXPECTED	Il n’existe aucun élément Device dans le document de description spécifié.
UPNP_E_DEVICE_NODE_INCOMPLETE	Le document XML ne contient pas l’un des éléments requis de l’élément Device.
UPNP_E_ICON_ELEMENT_EXPECTED	Le document XML n’a pas d’élément icône. Il est absent de l’élément IconList ou l’élément DeviceList ne contient pas d’élément IconList.
UPnP_E_ICON_ELEMENT_EXPECTED	Il n’existe aucun élément Icon dans le document de description spécifié.
UPNP_E_ICON_NODE_INCOMPLETE	Le document XML ne contient pas l’un des éléments requis de l’élément Icon.
UPnP_E_ICON_NODE_INCOMPLETE	Il n’existe aucun nœud d’icône dans le document de description spécifié.
UPNP_E_ROOT_ELEMENT_EXPECTED	Le document XML n’a pas d’élément racine au niveau supérieur du document.
UPnP_E_ROOT_ELEMENT_EXPECTED	Il n’existe aucun élément Racine dans le document de description spécifié.
UPNP_E_SERVICE_ELEMENT_EXPECTED	Le document XML n’a pas d’élément de service. Il est absent de l’élément ServiceList, ou l’élément DeviceList ne contient pas d’élément ServiceList.
UPNP_E_SERVICE_NODE_INCOMPLETE	Il manque au document XML l’un des éléments requis de l’élément Service.

Remarques

Cette méthode ne doit pas être appelée à partir d’un thread d’interface utilisateur, car le retour de la méthode peut prendre beaucoup de temps.

Si la méthode Load est appelée par un script dans une page web, bstrUrl peut être une URL relative. L’adresse de la page web active est utilisée comme URL de base.

Si cette méthode est appelée à partir d’une page Web, l’URL spécifiée par l’appelant doit faire référence au serveur à partir duquel la page web a été chargée.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	upnp.h
DLL	Upnp.dll

Voir aussi

IUPnPDescriptionDocument

IUPnPDescriptionDocument::LoadAsync

Partager via