Función WsAddressMessage (webservices.h)

Direcciona un mensaje a una dirección de extremo especificada.

Sintaxis

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

Parámetros

[in] message

Puntero a una estructura de WS_MESSAGE que representa el mensaje que se va a solucionar.

[in, optional] address

Puntero a una estructura de WS_ENDPOINT_ADDRESS que contiene el punto de conexión al que se dirige el mensaje.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Comentarios

Si no dirige un mensaje mediante una llamada a esta función, el canal dirige automáticamente el mensaje con la dirección de punto de conexión pasada a WsOpenChannel.

Esta función marca el mensaje como direccionado estableciendo la propiedad WS_MESSAGE_PROPERTY_IS_ADDRESSED en TRUE.

Esta función produce un error si el mensaje ya se ha solucionado y devuelve WS_E_INVALID_OPERATION.

Si se pasa un WS_ENDPOINT_ADDRESS distinto de NULL a la función, la función realiza los pasos adicionales siguientes:

• El tipo de encabezado se establece en WS_TO_HEADER (vea la enumeración WS_HEADER_TYPE ) y la dirección se establece en el valor del campo url de WS_ENDPOINT_ADDRESS. Si la longitud de la dirección URL es cero, la representación específica del WS_ADDRESSING_VERSION para una dirección URL anónima se establece para el mensaje.
• Cada encabezado del WS_XML_BUFFER especificado en el campo encabezados del WS_ENDPOINT_ADDRESS se agrega al mensaje. No se agregan encabezados si el búfer es NULL.

Requisitos