Compartilhar via

Função WsReadEndpointAddressExtension (webservices.h)

  • Artigo

Lê uma extensão do WS_ENDPOINT_ADDRESS.

Sintaxe

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

Parâmetros

[in] reader

O leitor XML a ser usado para ler a extensão.

A função definirá automaticamente a entrada do leitor conforme necessário para ler as extensões.

[in] endpointAddress

O endereço do ponto de extremidade que contém as extensões.

[in] extensionType

O tipo de extensão a ser lida.

[in] readOption

Se o valor é necessário e como alocar o valor. Consulte WS_READ_OPTION para obter mais informações.

Esse parâmetro pode ter um dos seguintes valores:

[in] heap

O heap a ser usado para armazenar o valor lido.

value

O endereço de um buffer para colocar o valor lido.

Se estiver usando WS_READ_REQUIRED_VALUE para o parâmetro readOption, o buffer deverá ser o tamanho do tipo de extensão que está sendo lida (que varia de acordo com WS_ENDPOINT_ADDRESS_EXTENSION_TYPE).

Se estiver usando WS_READ_REQUIRED_POINTER ou WS_READ_OPTIONAL_POINTER, o buffer deverá ser do tamanho de um ponteiro.

[in] valueSize

O tamanho do buffer que o chamador alocou para o valor lido.

Esse tamanho deve corresponder ao tamanho do buffer passado usando o parâmetro value.

[in, optional] error

Especifica onde informações adicionais de 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
E_INVALIDARG
 O tipo de extensão não era válido.

O tamanho do buffer fornecido não estava correto.

Um parâmetro necessário era NULL.
WS_E_INVALID_FORMAT
 Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
E_OUTOFMEMORY
 Ficou sem memória.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

O valor retornado é válido até que o heap seja liberado ou redefinido.

Se o tipo de extensão solicitado aparecer mais de uma vez no buffer de extensões, a primeira instância será retornada.

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