Fonction WsCloseServiceHost (webservices.h)

Article
03/03/2024

Ferme la communication avec l’hôte de service spécifié.

Syntaxe

HRESULT WsCloseServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Paramètres

[in] serviceHost

Pointeur vers une structure WS_SERVICE_HOST qui représente l’hôte de service à fermer.

[in, optional] asyncContext

Pointeur vers une structure WS_ASYNC_CONTEXT contenant des informations permettant d’appeler la fonction de manière asynchrone. Passez la valeur NULL pour appeler la fonction de manière synchrone.

[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, il retourne un code d’erreur HRESULT.

Code de retour	Description
WS_S_ASYNC	L’opération asynchrone est toujours en attente.
WS_E_INVALID_OPERATION	L’état actuel de l’hôte de service n’est pas valide pour cette opération.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
WS_E_OPERATION_TIMED_OUT	L’opération ne s’est pas terminée dans le délai imparti.
WS_E_OPERATION_ABORTED	L'opération a été abandonnée.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

WsCloseServiceHost ferme tous les écouteurs sur l’hôte de service. Par conséquent, aucun nouveau canal n’est accepté à partir du client. Toutefois, les E/S en attente sur les canaux déjà acceptés sont autorisées à se terminer.

Cela a des implications pour les points de terminaison configurés pour s’exécuter avec des liaisons de canal basées sur la session. Si un client a une session ouverte avec un service sur un tel point de terminaison, la fermeture ne se terminera pas tant que le client n’aura pas fermé la session avec le service.

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

Partager via