Funzione WsAbortListener (webservices.h)

Articolo
03/03/2024

Annulla qualsiasi I/O in sospeso per il listener specificato.

Sintassi

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Parametri

[in] listener

Puntatore a una struttura WS_LISTENER che rappresenta il listener per il quale annullare l'I/O.

[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.

Commenti

WsAbortListener può essere chiamato quando il listener è in qualsiasi stato. Per i possibili stati, vedere l'enumerazione WS_LISTENER_STATE . Se il listener si trova nello stato WS_LISTENER_STATE_OPEN, questa funzione forza l'errore del listener (reimpostato sullo stato WS_LISTENER_STATE_FAULTED). Quando si verifica un errore in un listener, tutti i tentativi di accettare un messaggio non riescono immediatamente con il codice di errore WS_E_OBJECT_FAULTED.

Questa funzione non attende il completamento dell'I/O in sospeso.

Se viene chiamato con parametri validi, questa funzione non avrà esito negativo per motivi come la mancanza di risorse di sistema.

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