Função WsGetHeaderAttributes (webservices.h)

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