Funzione WsAbortServiceProxy (webservices.h)

Articolo
03/03/2024

Interrompe il proxy del servizio e annulla qualsiasi I/O in sospeso nel proxy del servizio.

Sintassi

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

Parametri

[in] serviceProxy

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

[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
E_INVALIDARG	Uno o più argomenti non sono validi.

Commenti

WsAbortServiceProxy mostra il comportamento seguente a seconda dello stato del proxy di servizio (vedere l'enumerazione WS_SERVICE_PROXY_STATE per gli stati possibili):

Se il proxy del servizio viene aperto e nello stato WS_SERVICE_PROXY_STATE_OPENING, è possibile chiamare WsAbortServiceProxy per interrompere l'operazione di apertura. Il proxy del servizio annulla tutte le operazioni di I/O in sospeso e torna allo stato di WS_SERVICE_PROXY_STATE_CREATED.
Se il proxy del servizio è già aperto e nello stato WS_SERVICE_PROXY_STATE_OPEN, WsAbortServiceProxy causerà l'interruzione di tutti i canali sottostanti e la transizione allo stato di WS_SERVICE_PROXY_STATE_FAULTED. Dopo aver avviato l'interruzione, il proxy del servizio non accetterà nuove chiamate. L'applicazione può chiamare WsCloseServiceProxy per chiuderla
Se il proxy del servizio chiude e nello stato WS_SERVICE_PROXY_STATE_CLOSING, tutti i canali sottostanti vengono interrotti e il proxy del servizio passa allo stato WS_SERVICE_PROXY_STATE_CLOSED.

Per un esempio di uso di questa funzione, vedere ServiceCancellationExample.

Requisiti

Requisito	Valore
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