Método IUPnPDescriptionDocument::Load (upnp.h)
O método Load carrega um documento de forma síncrona. Esse método não retorna o controle ao chamador até que a operação de carregamento seja concluída.
Sintaxe
HRESULT Load(
[in] BSTR bstrUrl
);
Parâmetros
[in] bstrUrl
Especifica a URL do documento a ser carregado.
Valor retornado
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h ou um dos seguintes valores retornados UPnP.
| Código de retorno | Descrição |
|---|---|
|
O documento XML não tem um elemento de dispositivo. Ele está ausente do elemento raiz ou do elemento DeviceList. |
|
Não há nenhum elemento Device no documento de descrição especificado. |
|
O documento XML não tem um dos elementos necessários do elemento Device. |
|
O documento XML não tem um elemento de ícone. Ele está ausente do elemento IconList ou o elemento DeviceList não contém um elemento IconList. |
|
Não há nenhum elemento Icon no documento de descrição especificado. |
|
O documento XML não tem um dos elementos necessários do elemento Icon. |
|
Não há nenhum Nó de Ícone no documento de descrição especificado. |
|
O documento XML não tem um elemento raiz no nível superior do documento. |
|
Não há nenhum elemento Root no documento de descrição especificado. |
|
O documento XML não tem um elemento de serviço. Ele está ausente do elemento ServiceList ou o elemento DeviceList não contém um elemento ServiceList. |
|
O documento XML não tem um dos elementos necessários do elemento Service. |
Comentários
Esse método não deve ser chamado de um thread de interface do usuário porque pode levar muito tempo para que o método retorne.
Se o método Load for chamado por um script em uma página da Web, bstrUrl poderá ser uma URL relativa. O endereço da página da Web atual é usado como a URL base.
Se esse método for chamado de uma página da Web, a URL especificada pelo chamador deverá se referir ao mesmo servidor do qual a página da Web foi carregada.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | upnp.h |
| DLL | Upnp.dll |