WsAbortServiceProxy, fonction (webservices.h)
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 |
---|---|
|
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 |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour