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.

[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.

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