Função WsAddressMessage (webservices.h)

Endereça uma mensagem a um endereço de ponto de extremidade especificado.

Sintaxe

HRESULT WsAddressMessage(
  [in]           WS_MESSAGE                *message,
  [in, optional] const WS_ENDPOINT_ADDRESS *address,
  [in, optional] WS_ERROR                  *error
);

Parâmetros

[in] message

Ponteiro para uma estrutura WS_MESSAGE que representa a mensagem a ser endereçada.

[in, optional] address

Ponteiro para uma estrutura WS_ENDPOINT_ADDRESS que contém o ponto de extremidade para o qual abordar a mensagem.

Nota Passar NULL para esse parâmetro indica que nenhum cabeçalho é adicionado à mensagem. Isso fornece uma maneira de definir o WS_MESSAGE_PROPERTY_ID como WS_MESSAGE_PROPERTY_IS_ADDRESSED sem modificar o conjunto de cabeçalhos na mensagem.

 

[in, optional] error

Ponteiro para uma estrutura de WS_ERROR que recebe informações de erro adicionais se a função falhar.

Valor retornado

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retorna um código de erro HRESULT.

Código de retorno	Descrição
WS_E_INVALID_OPERATION	A mensagem já foi endereçada. (A propriedade WS_MESSAGE_PROPERTY_IS_ADDRESSED indica se uma mensagem já foi endereçada.)
E_INVALIDARG	Um ou mais argumentos não são válidos.
WS_E_INVALID_FORMAT	Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.
Outros erros	Essa função pode retornar outros erros não listados acima.

Comentários

Se você não resolver uma mensagem chamando essa função, o canal abordará automaticamente a mensagem com o Endereço do Ponto de Extremidade passado para WsOpenChannel.

Essa função marca a mensagem como endereçada definindo a propriedade WS_MESSAGE_PROPERTY_IS_ADDRESSED como TRUE.

Essa função falhará se a mensagem já tiver sido endereçada e retornar WS_E_INVALID_OPERATION.

Se um WS_ENDPOINT_ADDRESS não NULL for passado para a função, a função executará as seguintes etapas adicionais:

• O tipo de cabeçalho é definido como WS_TO_HEADER (consulte a enumeração WS_HEADER_TYPE ) e o endereço é definido como o valor do campo url de WS_ENDPOINT_ADDRESS. Se o comprimento da URL for zero, a representação específica do WS_ADDRESSING_VERSION para uma URL anônima será definida para a mensagem.
• Cada cabeçalho no WS_XML_BUFFER especificado no campo cabeçalhos do WS_ENDPOINT_ADDRESS é adicionado à mensagem. Nenhum cabeçalho será adicionado se o buffer for NULL.

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