WsCloseServiceProxy, fonction (webservices.h)

Article
08/27/2023

Ferme la communication avec le proxy de service spécifié.

Syntaxe

HRESULT WsCloseServiceProxy(
  [in]           WS_SERVICE_PROXY       *serviceProxy,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Paramètres

[in] serviceProxy

Pointeur vers une structure WS_SERVICE_PROXY représentant le proxy 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, elle 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 du proxy de service n’est pas valide pour cette opération. Il s’agit uniquement d’une erreur pour laquelle la fermeture échoue.
WS_E_ENDPOINT_DISCONNECTED	Le WS_CHANNEL sous-jacent a été déconnecté pendant l’opération de fermeture. Cette erreur se produit uniquement dans les cas où le canal sous-jacent est basé sur une session.
WS_E_OPERATION_ABORTED	L'opération a été abandonnée.
WS_E_ENDPOINT_FAILURE	Le point de terminaison distant n’a pas pu traiter la demande.
WS_E_INVALID_FORMAT	Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
WS_E_OPERATION_TIMED_OUT	L’opération ne s’est pas terminée dans le délai imparti.
WS_E_QUOTA_EXCEEDED	Un quota a été dépassé.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
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

Si un appel d’opération de service est en attente sur le proxy de service, WsCloseServiceProxy attend la fin de chaque appel. Après avoir appelé l’application WsCloseServiceProxy ne doit plus effectuer d’appels sur le proxy de service.

Notez que WS_E_INVALID_OPERATION est le seul
code d’erreur qui indique que la fermeture a échoué. D’autres codes d’erreur indiquent que l’opération a réussi, et le code d’erreur est uniquement à titre d’information.

Configuration requise


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