Función WsResetMessage (webservices.h)

  • Artículo

Vuelve a establecer el estado del mensaje en WS_MESSAGE_STATE_EMPTY. En este estado, se puede reutilizar el objeto Message.

Sintaxis

HRESULT WsResetMessage(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

Parámetros

[in] message

Puntero al objeto Message que se va a restablecer.

[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
E_INVALIDARG
 Uno o más argumentos no son válidos.

Comentarios

Cuando se restablece un mensaje, se restablece su montón subyacente.

La reutilización de un objeto de mensaje para recibir o enviar varios mensajes suele ser más eficaz que crear y liberar el objeto de mensaje para cada mensaje.

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