WsAbortChannel, fonction (webservices.h)

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 WS_CHANNEL représentant le canal pour lequel annuler les E/S.

[in, optional] error

Pointeur vers une structure WS_ERROR qui reçoit des informations d’erreur supplémentaires si la fonction échoue.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR; sinon, il 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.

Notes

Windows Server 2003 et avant : Sur les plateformes Windows avant 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 prise en charge pour WS_HTTP_CHANNEL_BINDING avec WS_CHANNEL_TYPE_REPLY lors de l’abandon d’un canal dans l’état WS_CHANNEL_STATE_OPEN ou WS_CHANNEL_STATE_FAULTED. (Pour plus d’informations sur les types de canal, consultez l’énumération WS_CHANNEL_TYPE .

WsAbortChannel peut être appelé pour un canal dans n’importe quel état, et n’attend pas que les E/S en attente soient terminées avant d’abandonner le canal.

Si le canal se trouve dans 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 ne échoue pas pour des raisons telles qu’un manque de ressources système. Toutefois, notez les limitations sur 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