Partager via


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.

Code de retour Description
E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.

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

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête webservices.h
Bibliothèque WebServices.lib
DLL WebServices.dll