Partager via

WsResetChannel, fonction (webservices.h)

  • Article

Réinitialisez un canal afin qu’il puisse être réutilisé.

Syntaxe

HRESULT WsResetChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

Paramètres

[in] channel

Canal à réinitialiser.

[in, optional] error

Spécifie l’emplacement où des informations d’erreur supplémentaires 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
WS_E_INVALID_OPERATION
 Le canal était dans un état inapproprié.

Remarques

La réutilisation d’un canal au lieu d’en créer un à partir de zéro peut améliorer les performances.

Cette fonction n’est valide que lorsque le canal est à l’état WS_CHANNEL_STATE_CREATED ou WS_CHANNEL_STATE_CLOSED .

Si elle est appelée correctement, cette fonction n’échoue pas (par exemple, en raison d’un manque de ressources système).

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