Compartilhar via

Função WsReadMetadata (webservices.h)

  • Artigo

Lê um elemento Metadata e o adiciona aos documentos de metadados do objeto Metadata.

O estado do objeto Metadados deve ser definido como WS_METADATA_STATE_CREATED.

No erro, o estado do objeto Metadados é redefinido para WS_METADATA_STATE_FAULTED.

Nota A função consumirá um elemento se o elemento contiver metadados. Se o elemento não for reconhecido como contendo metadados ou se o tipo específico de metadados não for necessário, o elemento não será lido.
 

Sintaxe

HRESULT WsReadMetadata(
  [in]           WS_METADATA     *metadata,
  [in]           WS_XML_READER   *reader,
  [in]           const WS_STRING *url,
  [in, optional] WS_ERROR        *error
);

Parâmetros

[in] metadata

Um ponteiro para o objeto Metadados para armazenar os metadados lidos. O ponteiro deve referenciar um objeto de WS_METADATA válido.

[in] reader

Um ponteiro para o objeto Leitor de XML usado para ler os metadados. O ponteiro deve referenciar um objeto WS_XML_READER válido e o leitor deve ser posicionado no elemento que contém os metadados desejados.

[in] url

Um ponteiro para um objeto WS_STRING referenciando a URL de metadados recuperada. A URL é usada para acompanhar os documentos de metadados para resolver links baseados em URL entre documentos.

Nota A URL DEVE ser totalmente qualificada. A URL pode ter um identificador de fragmento.
 

Há suporte para os seguintes esquemas de URL:

  • WS_URL_HTTP_SCHEME_TYPE
  • WS_URL_HTTPS_SCHEME_TYPE
  • WS_URL_NETTCP_SCHEME_TYPE
Cada URL especificada usando essa função deve ter uma URL base exclusiva. A URL base é calculada removendo qualquer identificador de fragmento da URL especificada.

Por exemplo, se as seguintes URLs foram especificadas:


http://example.com/document1#fragment
http://example.com/document2

As duas URLs base seriam:


http://example.com/document1
http://example.com/document2

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
WS_E_INVALID_FORMAT
 Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
WS_E_INVALID_OPERATION
 A operação não é permitida devido ao estado atual do objeto.
WS_E_QUOTA_EXCEEDED
 Uma cota foi excedida.
E_OUTOFMEMORY
 Ficou sem memória.
E_INVALIDARG
 Um ou mais argumentos são inválidos.
S_FALSE
 O elemento não foi consumido.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Essa função reconhece os seguintes tipos de metadados:

  • Documentos do WSDL 1.1
  • documentos do WS-Policy 1.2

Requisitos

Requisito Valor
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