Compartir a través de


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