WsAbortChannel, fonction (webservices.h)

  • Article

Annule toutes les E/S en attente pour un canal spécifié

Syntaxe

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

Paramètres

[in] channel

Pointeur vers une structure de WS_CHANNEL représentant le canal pour lequel annuler les E/S.

[in, optional] error

Pointeur vers une structure de WS_ERROR qui reçoit des informations d’erreur supplémentaires en cas d’échec de la fonction.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR ; sinon, elle retourne un code d’erreur HRESULT.

Code de retour Description
WS_E_NOT_SUPPORTED
 Consultez la section Remarques pour connaître les limitations de la plateforme.
E_INVALIDARG
 Un ou plusieurs arguments ne sont pas valides.

Remarques

Windows Server 2003 et versions antérieures : Sur les plateformes Windows antérieures à Windows Vista, cette fonction n’est pas prise en charge pour WS_UDP_CHANNEL_BINDING ou WS_HTTP_CHANNEL_BINDING si le canal est dans l’état WS_CHANNEL_STATE_ACCEPTING et que l’écouteur n’a pas déjà été abandonné.

(Pour plus d’informations sur les liaisons de canal et les états de canal, consultez les énumérations WS_CHANNEL_BINDING et WS_CHANNEL_STATE .)

Cette fonction n’est pas non plus prise en charge pour les WS_HTTP_CHANNEL_BINDING avec WS_CHANNEL_TYPE_REPLY lors de l’abandon d’un canal à l’état WS_CHANNEL_STATE_OPEN ou WS_CHANNEL_STATE_FAULTED. (Pour plus d’informations sur les types de canaux, consultez l’énumération WS_CHANNEL_TYPE .

WsAbortChannel peut être appelé pour un canal dans n’importe quel état et n’attend pas la fin des E/S en attente avant d’abandonner le canal.

Si le canal est à l’état WS_CHANNEL_STATE_OPEN , WsAbortChannel provoque l’erreur du canal à l’état WS_CHANNEL_STATE_FAULTED .

Note Consultez WsAbandonMessage pour plus d’informations sur la façon d’ignorer un message particulier et de garder le canal ouvert.

 
Si elle est appelée avec des paramètres valides, cette fonction n’échoue pas pour des raisons telles qu’un manque de ressources système. Toutefois, notez les limitations de certaines versions de systèmes d’exploitation au début des remarques.

Configuration requise

   
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