Metodo IUPnPDescriptionDocument::Load (upnp.h)
Il metodo Load carica un documento in modo sincrono. Questo metodo non restituisce il controllo al chiamante fino al completamento dell'operazione di caricamento.
Sintassi
HRESULT Load(
[in] BSTR bstrUrl
);
Parametri
[in] bstrUrl
Specifica l'URL del documento da caricare.
Valore restituito
Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il metodo restituisce uno dei codici di errore COM definiti in WinError.h o uno dei valori restituiti UPnP seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il documento XML non ha un elemento del dispositivo. Manca dall'elemento radice o dall'elemento DeviceList. |
|
Non esiste alcun elemento Device nel documento di descrizione specificato. |
|
Il documento XML manca uno degli elementi necessari dall'elemento Device. |
|
Il documento XML non ha un elemento icona. Manca dall'elemento IconList o l'elemento DeviceList non contiene un elemento IconList. |
|
Non è presente alcun elemento Icon nel documento di descrizione specificato. |
|
Il documento XML manca uno degli elementi necessari dall'elemento Icon. |
|
Non esiste alcun nodo icona nel documento di descrizione specificato. |
|
Il documento XML non ha un elemento radice a livello superiore del documento. |
|
Non esiste alcun elemento Root nel documento di descrizione specificato. |
|
Il documento XML non ha un elemento del servizio. Manca dall'elemento ServiceList o l'elemento DeviceList non contiene un elemento ServiceList. |
|
Il documento XML manca uno degli elementi necessari dall'elemento Service. |
Commenti
Questo metodo non deve essere chiamato da un thread dell'interfaccia utente perché può richiedere molto tempo per restituire il metodo.
Se il metodo Load viene chiamato da uno script all'interno di una pagina Web, bstrUrl può essere un URL relativo. L'indirizzo della pagina Web corrente viene usato come URL di base.
Se questo metodo viene chiamato da una pagina Web, l'URL specificato dal chiamante deve fare riferimento allo stesso server da cui è stata caricata la pagina Web.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | upnp.h |
| DLL | Upnp.dll |