Método IUPnPDescriptionDocument::Load (upnp.h)
El método Load carga un documento de forma sincrónica. Este método no devuelve el control al autor de la llamada hasta que se complete la operación de carga.
Sintaxis
HRESULT Load(
[in] BSTR bstrUrl
);
Parámetros
[in] bstrUrl
Especifica la dirección URL del documento que se va a cargar.
Valor devuelto
Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en WinError.h o uno de los siguientes valores devueltos de UPnP.
| Código devuelto | Descripción |
|---|---|
|
El documento XML no tiene un elemento device. Falta el elemento raíz o el elemento DeviceList. |
|
No hay ningún elemento Device en el documento de descripción especificado. |
|
Falta el documento XML uno de los elementos necesarios del elemento Device. |
|
El documento XML no tiene un elemento icon. Falta el elemento IconList o el elemento DeviceList no contiene un elemento IconList. |
|
No hay ningún elemento Icon en el documento de descripción especificado. |
|
Falta el documento XML uno de los elementos necesarios del elemento Icon. |
|
No hay ningún nodo de icono en el documento de descripción especificado. |
|
El documento XML no tiene un elemento raíz en el nivel superior del documento. |
|
No hay ningún elemento Root en el documento de descripción especificado. |
|
El documento XML no tiene un elemento de servicio. Falta el elemento ServiceList o el elemento DeviceList no contiene un elemento ServiceList. |
|
Falta el documento XML uno de los elementos necesarios del elemento Service. |
Comentarios
No se debe llamar a este método desde un subproceso de interfaz de usuario porque el método puede tardar mucho tiempo en devolverse.
Si un script llama al método Load dentro de una página web, bstrUrl puede ser una dirección URL relativa. La dirección de la página web actual se usa como dirección URL base.
Si se llama a este método desde una página web, la dirección URL que especifica el autor de la llamada debe hacer referencia al mismo servidor desde el que se cargó la página web.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | upnp.h |
| Archivo DLL | Upnp.dll |