Funzione WsCloseServiceProxy (webservices.h)

Articolo
08/27/2023

Chiude la comunicazione con il proxy del servizio specificato.

Sintassi

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

Parametri

[in] serviceProxy

Puntatore a una struttura WS_SERVICE_PROXY che rappresenta il proxy del servizio da chiudere.

[in, optional] asyncContext

Puntatore a una struttura WS_ASYNC_CONTEXT contenente informazioni per richiamare la funzione in modo asincrono. Passare NULL per richiamare la funzione in modo sincrono.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore 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_S_ASYNC	L'operazione asincrona è ancora in sospeso.
WS_E_INVALID_OPERATION	Lo stato corrente del proxy del servizio non è valido per questa operazione. Si tratta solo di un errore per il quale la chiusura avrà esito negativo.
WS_E_ENDPOINT_DISCONNECTED	Il WS_CHANNEL sottostante è stato disconnesso durante l'operazione di chiusura. Questo errore si verifica solo nei casi in cui il canale sottostante è basato sulla sessione.
WS_E_OPERATION_ABORTED	L'operazione è stata interrotta.
WS_E_ENDPOINT_FAILURE	L'endpoint remoto non è riuscito a elaborare la richiesta.
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.
WS_E_OPERATION_TIMED_OUT	L'operazione non è stata completata entro il tempo assegnato.
WS_E_QUOTA_EXCEEDED	È stata superata una quota.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_INVALIDARG	Uno o più argomenti non sono validi.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Se una chiamata all'operazione del servizio è in sospeso nel proxy del servizio, WsCloseServiceProxy attende il completamento di ogni chiamata. Dopo aver chiamato l'applicazione WsCloseServiceProxy non deve eseguire altre chiamate sul proxy del servizio.

Si noti che WS_E_INVALID_OPERATION è l'unico
codice di errore che indica che la chiusura non è riuscita. Altri codici di errore indicano che l'operazione è riuscita e il codice di errore è solo a scopo informativo.

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