WsAbortListener, fonction (webservices.h)

Annule toutes les E/S en attente pour l’écouteur spécifié.

Syntaxe

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Paramètres

[in] listener

Pointeur vers une structure WS_LISTENER représentant l’écouteur 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.

Remarques

WsAbortListener peut être appelé lorsque l’écouteur est dans n’importe quel état. (Consultez l’énumération WS_LISTENER_STATE pour connaître les états possibles.) Si l’écouteur est dans l’état WS_LISTENER_STATE_OPEN, cette fonction force l’écouteur à faire une erreur (réinitialisé à l’état WS_LISTENER_STATE_FAULTED). Lorsqu’un écouteur est défaillant, toutes les tentatives d’acceptation d’un message de sa part échouent immédiatement avec le code d’erreur WS_E_OBJECT_FAULTED.

Cette fonction n’attend pas la fin des E/S en attente.

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.

Configuration requise

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