WsResetMessage, fonction (webservices.h)

Rétablit l’état message sur WS_MESSAGE_STATE_EMPTY. Dans cet état, l’objet Message peut être réutilisé.

Syntaxe

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

Paramètres

[in] message

Pointeur vers l’objet Message à réinitialiser.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

Lorsqu’un message est réinitialisé, son tas sous-jacent est réinitialisé.

La réutilisation d’un objet message pour recevoir ou envoyer plusieurs messages est généralement plus efficace que la création et la libération de l’objet message pour chaque message.

Configuration requise