WsAbandonCall, fonction (webservices.h)

Article
08/27/2023

Abandonne un appel spécifié sur le proxy de service spécifié.

Syntaxe

HRESULT WsAbandonCall(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in]           ULONG            callId,
  [in, optional] WS_ERROR         *error
);

Paramètres

[in] serviceProxy

Pointeur vers une structure WS_SERVICE_PROXY représentant le proxy de service sur lequel abandonner l’appel.

[in] callId

ID de l’appel à abandonner. (Consultez la section Notes).

[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_E_INVALID_OPERATION	L’état actuel du proxy de service n’est pas valide pour cette opération.
E_INVALIDARG	Un proxy de service NULL a été passé à la fonction .

Remarques

Les appels sont identifiés par un ID d’appel. Cet ID d’appel est associé à l’appel par la valeur WS_CALL_PROPERTY_CALL_ID de l’énumération WS_CALL_PROPERTY_ID .

Si l’ID d’appel est 0, tous les appels en attente sur le proxy de service sont abandonnés. Pour plus d'informations, voir les rubriques suivantes :

N’oubliez pas que les E/S réelles associées à l’appel ne sont pas annulées. Le proxy de service conserve les ressources pour terminer l’appel même si l’appel a été abandonné.

Cela entraîne une consommation de ressources qui est aggravée si une application continue d’abandonner les appels, comme cela peut se produire lorsque le serveur est lent à répondre au client et que l’application cliente abandonne un seul appel pour refaire le même appel.

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