Compartilhar via

Função WsGetHeaderAttributes (webservices.h)

  • Artigo

Essa função preenche um parâmetro ULONG com o WS_HEADER_ATTRIBUTES do elemento de cabeçalho no qual o leitor está posicionado. A versão do envelope da mensagem é usada para determinar quais atributos retornar.

Sintaxe

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] message

Um ponteiro para uma estrutura WS_MESSAGE que contém a mensagem a ser consultada. Essa versão de envelope da mensagem é usada para determinar quais atributos correspondem. A mensagem pode estar em qualquer estado, exceto WS_MESSAGE_STATE_EMPTY.

[in] reader

Um ponteiro para o leitor a ser consultado. Isso deve ser válido WS_XML_READER objeto retornado de WsCreateReader e não pode ser NULL.

[out] headerAttributes

Em caso de êxito, o valor referenciado por esse ponteiro é definido como os atributos de cabeçalho.

[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
E_OUTOFMEMORY
 Ficou sem memória.
E_INVALIDARG
 Um ou mais argumentos são inválidos.
WS_E_INVALID_FORMAT
 Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Supõe-se que o leitor aponte para um elemento de cabeçalho. Use a API do leitor XML para posicionar o leitor adequadamente.

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