Función WsSendReplyMessage (webservices.h)

Envía un mensaje que es una respuesta a un mensaje recibido.

Sintaxis

HRESULT WsSendReplyMessage(
  [in]           WS_CHANNEL                   *channel,
  [in]           WS_MESSAGE                   *replyMessage,
  [in]           const WS_MESSAGE_DESCRIPTION *replyMessageDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *replyBodyValue,
  [in]           ULONG                        replyBodyValueSize,
  [in]           WS_MESSAGE                   *requestMessage,
  [in, optional] const WS_ASYNC_CONTEXT       *asyncContext,
  [in, optional] WS_ERROR                     *error
);

Parámetros

[in] channel

Puntero al objeto Channel en el que se va a enviar el mensaje de respuesta. El puntero debe hacer referencia a un objeto WS_CHANNEL válido.

[in] replyMessage

Puntero al objeto Message para enviar la respuesta. El puntero debe hacer referencia a un objeto WS_MESSAGE válido.

El estado del objeto de mensaje debe establecerse en WS_MESSAGE_STATE_EMPTY o WS_MESSAGE_STATE_INITIALIZED.

Nota Si se proporciona un mensaje inicializado, se debe inicializar mediante WS_REPLY_MESSAGE o WS_FAULT_MESSAGE.

 

[in] replyMessageDescription

Puntero a un objeto WS_MESSAGE_DESCRIPTION . El campo de acción de WS_MESSAGE_DESCRIPTION se usa como encabezado de acción para el mensaje de respuesta. Este campo puede ser NULL si no se requiere ninguna acción.

El campo bodyElementDescription del WS_MESSAGE_DESCRIPTION se usa para serializar el cuerpo del mensaje de respuesta. Este campo puede ser NULL si no se desea ningún elemento body. Vea WsWriteBody para obtener información sobre cómo se usa bodyElementDescription para serializar un valor.

[in] writeOption

Determina si se requiere el elemento body y cómo se asigna el valor.

Consulte WS_WRITE_OPTION para obtener más información.

replyBodyValue

Puntero void al valor que se va a serializar en el mensaje de respuesta.

[in] replyBodyValueSize

Tamaño en bytes del valor de respuesta que se serializa.

[in] requestMessage

Puntero a un objeto WS_MESSAGE que encapsula el texto del mensaje de solicitud. Se usa para obtener información de correlación utilizada para formular el mensaje de respuesta.

Nota El mensaje puede estar en cualquier estado excepto WS_MESSAGE_STATE_EMPTY.

 

[in, optional] asyncContext

Puntero a una estructura de datos WS_ASYNC_CONTEXT con información sobre la invocación de la función de forma asincrónica. Un valor NULL indica una solicitud de operación sincrónica.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
WS_S_ASYNC	La operación asincrónica sigue pendiente.
WS_E_OPERATION_ABORTED	Se anuló la operación.
WS_E_INVALID_OPERATION	No se permite la operación debido al estado actual del objeto .
WS_E_ENDPOINT_DISCONNECTED	Se finalizó la conexión con el punto de conexión remoto.
WS_E_INVALID_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
WS_E_OPERATION_TIMED_OUT	La operación no se completó dentro del tiempo asignado.
WS_E_QUOTA_EXCEEDED	Se superó una cuota.
WS_E_SECURITY_VERIFICATION_FAILURE	La comprobación de seguridad no se realizó correctamente para los datos recibidos.
WS_E_SECURITY_SYSTEM_FAILURE	Error en una operación de seguridad en el marco de servicios web de Windows.
WS_E_SECURITY_TOKEN_EXPIRED	El servidor rechazó un token de seguridad porque ha expirado.
E_OUTOFMEMORY	Se quedó sin memoria.
E_INVALIDARG	Uno o más argumentos no son válidos.
Otros errores	Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

El mensaje de respuesta incluirá la información de correlación según corresponda al WS_ADDRESSING_VERSION. Consulte Información general sobre la capa de canal para obtener más información sobre cómo correlacionar los mensajes de respuesta de solicitud.

Requisitos

Requisito	Value
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