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.

Nota Pasar NULL a este parámetro indica que no se agregan encabezados al mensaje. Esto proporciona una manera de establecer el WS_MESSAGE_PROPERTY_ID en WS_MESSAGE_PROPERTY_IS_ADDRESSED sin modificar el conjunto de encabezados en 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.

Código devuelto	Descripción
WS_E_INVALID_OPERATION	El mensaje ya se ha solucionado. (La propiedad WS_MESSAGE_PROPERTY_IS_ADDRESSED indica si ya se ha solucionado un mensaje).
E_INVALIDARG	Uno o varios argumentos no son válidos.
WS_E_INVALID_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
E_OUTOFMEMORY	Memoria insuficiente para completar la operación.
Otros errores	Esta función puede devolver otros errores no enumerados anteriormente.

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

Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	webservices.h
Library	WebServices.lib
Archivo DLL	WebServices.dll