Compartilhar via


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:

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