WsAbortServiceProxy, fonction (webservices.h)

Article
08/27/2023

Abandonne le proxy de service et annule toutes les E/S en attente sur le proxy de service.

Syntaxe

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

Paramètres

[in] serviceProxy

Pointeur vers une structure de WS_SERVICE_PROXY représentant le proxy de service à abandonner.

[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
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.

Remarques

WsAbortServiceProxy affiche le comportement suivant en fonction de l’état du proxy de service (consultez l’énumération WS_SERVICE_PROXY_STATE pour connaître les états possibles) :

Si le proxy de service s’ouvre et dans l’état WS_SERVICE_PROXY_STATE_OPENING, vous pouvez appeler WsAbortServiceProxy pour abandonner l’opération d’ouverture. Le proxy de service annule toutes les E/S en attente et revient à l’état WS_SERVICE_PROXY_STATE_CREATED.
Si le proxy de service est déjà ouvert et dans l’état WS_SERVICE_PROXY_STATE_OPEN, WsAbortServiceProxy entraîne l’abandon de tous les canaux sous-jacents et la transition vers l’état WS_SERVICE_PROXY_STATE_FAULTED. Une fois l’abandon lancé, le proxy de service n’accepte aucun nouvel appel. L’application peut appeler WsCloseServiceProxy pour la fermer
Si le proxy de service se ferme et dans l’état WS_SERVICE_PROXY_STATE_CLOSING, tous les canaux sous-jacents sont abandonnés et le proxy de service passe à l’état WS_SERVICE_PROXY_STATE_CLOSED.

Pour obtenir un exemple d’utilisation de cette fonction, consultez ServiceCancellationExample.

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

Partager via