Compartir a través de


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:

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