WsOpenServiceHost, fonction (webservices.h)

Article
08/27/2023

Ouvre un hôte de service pour la communication et démarre les écouteurs sur tous les points de terminaison. Les applications clientes ne peuvent pas se connecter aux points de terminaison de service tant que WsOpenSerivceHost n’est pas appelé.

Syntaxe

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

Paramètres

[in] serviceHost

Pointeur vers l’objet Hôte de service à ouvrir. Le pointeur doit référencer un objet WS_SERVICE_HOST valide retourné par WsCreateServiceHost et la valeur hôte de service référencée peut ne pas être NULL.

[in, optional] asyncContext

Pointeur vers un objet WS_ASYNC_CONTEXT qui contient des informations sur la façon d’appeler la fonction de manière asynchrone. La valeur est définie sur NULL en cas d’appel synchrone.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
WS_S_ASYNC	L’opération asynchrone est toujours en attente.
WS_E_OPERATION_ABORTED	L’hôte de service a été abandonné avant l’ouverture ou pendant l’ouverture.
WS_E_INVALID_OPERATION	L’état actuel du proxy de service n’est pas valide pour cette opération.
WS_E_ADDRESS_IN_USE	L’adresse est déjà utilisée.
WS_E_ADDRESS_NOT_AVAILABLE	L’adresse n’est pas valide pour ce contexte.
WS_E_QUOTA_EXCEEDED	Un quota a été dépassé.
WS_E_OPERATION_ABORTED	L'opération a été abandonnée.
WS_E_OPERATION_TIMED_OUT	L’opération ne s’est pas terminée dans le délai imparti.
E_OUTOFMEMORY	Mémoire insuffisante.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

Remarques

Notez que tous les écouteurs de points de terminaison doivent s’ouvrir correctement avant qu’un canal ne soit accepté par l’hôte de service pour communiquer avec le client.

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