Compartilhar via

Função WsGetMissingMetadataDocumentAddress (webservices.h)

  • Artigo

Essa função retorna o endereço de um documento ausente referenciado pelo objeto de metadados.

Cada documento adicionado ao objeto de metadados pode conter referências a outros documentos. Depois que um documento for adicionado novamente aos Metadados, a função poderá ser usada para localizar o próximo documento ausente.

Nota Essa função falhará se o nome do host da URL do endereço ausente que está sendo retornado não puder ser verificado como sendo um dos nomes de host esperados. Os nomes de host esperados são uma união do seguinte:
 

Sintaxe

HRESULT WsGetMissingMetadataDocumentAddress(
  [in]           WS_METADATA         *metadata,
                 WS_ENDPOINT_ADDRESS **address,
  [in, optional] WS_ERROR            *error
);

Parâmetros

[in] metadata

Esse parâmetro é um ponteiro para um objeto Metadados que deve ter o documento.

address

Com êxito, esse parâmetro é preenchido com um ponteiro para o endereço de um documento de metadados ausente ou NULL se não houver documentos de metadados ausentes.

A URL de endereço retornada é totalmente qualificada.

Nota Os dados retornados por essa função são válidos até que o objeto de metadados seja liberado ou redefinido. Os dados não devem ser modificados.
 

[in, optional] error

Esse parâmetro é um ponteiro WS_ERROR para onde informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função pode retornar um desses valores.

Código de retorno Descrição
E_INVALIDARG
 Um ou mais argumentos são inválidos.
E_OUTOFMEMORY
 Ficou sem memória.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Se essa função verificará ou não os nomes de host das URLs retornadas pode ser controlado usando o valor do enumerador WS_METADATA_PROPERTY_VERIFY_HOST_NAMES.

A finalidade da verificação do nome do host é garantir que um aplicativo não use o endereço sem saber que ele é de um host do qual está disposto a aceitar metadados.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll