WsOpenServiceHost, fonction (webservices.h)

  • Article

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