Funzione WsAbandonCall (webservices.h)

Articolo
08/27/2023

Abbandona una chiamata specificata nel proxy del servizio specificato.

Sintassi

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

Parametri

[in] serviceProxy

Puntatore a una struttura WS_SERVICE_PROXY che rappresenta il proxy del servizio su cui abbandonare la chiamata.

[in] callId

ID della chiamata da abbandonare. Vedere la sezione Note.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni di errore aggiuntive se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito	Descrizione
WS_E_INVALID_OPERATION	Lo stato corrente del proxy del servizio non è valido per questa operazione.
E_INVALIDARG	È stato passato un proxy di servizio NULL alla funzione.

Commenti

Le chiamate vengono identificate da un ID chiamata. Questo ID chiamata è associato alla chiamata dal valore WS_CALL_PROPERTY_CALL_ID dell'enumerazione WS_CALL_PROPERTY_ID .

Se l'ID chiamata è 0, tutte le chiamate in sospeso sul proxy del servizio vengono abbandonate. Per altre informazioni, vedere gli argomenti seguenti:

Tenere presente che l'I/O effettivo associato alla chiamata non viene annullato. Il proxy del servizio mantiene le risorse per completare la chiamata anche se la chiamata è stata abbandonata.

Ciò comporta un consumo di risorse aggravato se un'applicazione continua ad abbandonare le chiamate, come può verificarsi quando il server è lento a rispondere al client e l'applicazione client abbandona una sola chiamata per eseguire nuovamente la stessa chiamata.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite