Funzione WsCloseListener (webservices.h)

Articolo
03/03/2024

Fa sì che il listener specificato interrompa l'ascolto.

Sintassi

HRESULT WsCloseListener(
  [in]           WS_LISTENER            *listener,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parametri

[in] listener

Puntatore a una struttura WS_LISTENER che rappresenta il listener 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_OPERATION_ABORTED	La chiusura è stata interrotta da una chiamata a WsAbortListener perché il listener stava chiudendo.
WS_E_INVALID_OPERATION	Il listener era in uno stato inappropriato.
WS_E_OPERATION_TIMED_OUT	L'operazione non è stata completata entro il tempo assegnato.
E_INVALIDARG	Uno o più argomenti non sono validi.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Dopo la chiusura del listener, il listener può essere rilasciato in modo sicuro.

Questa operazione è consentita per il listener nello stato WS_LISTENER_STATE_OPEN o WS_LISTENER_STATE_FAULTED . Per gli stati del listener, vedere l'enumerazione WS_LISTENER_STATE .

Quando un listener viene chiuso, tutti i tentativi in sospeso di accettare un canale con il metodo WsAcceptChannel vengono interrotti. WsCloseListener attende tuttavia il completamento di eventuali operazioni di I/O in sospeso prima di procedere con il processo di chiusura.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite