PFN_WSK_ABORT_EVENT funzione di callback (wsk.h)
La funzione di callback dell'evento WskAbortEvent notifica a un'applicazione WSK che è stata eliminata una richiesta di connessione in ingresso in un socket di ascolto con modalità di accettazione condizionale abilitata.
Sintassi
PFN_WSK_ABORT_EVENT PfnWskAbortEvent;
NTSTATUS PfnWskAbortEvent(
[in, optional] PVOID SocketContext,
[in] PWSK_INSPECT_ID InspectID
)
{...}
Parametri
[in, optional] SocketContext
Puntatore al contesto del socket per il socket in ascolto in cui è stata ricevuta la richiesta di connessione in ingresso. L'applicazione WSK ha fornito questo puntatore al sottosistema WSK quando ha chiamato la funzione WskSocket per creare il socket di ascolto.
[in] InspectID
Puntatore a una struttura WSK_INSPECT_ID . Il contenuto della struttura identifica la richiesta di connessione in ingresso eliminata.
Valore restituito
La funzione di callback dell'evento WskAbortEvent dell'applicazione WskAbortEvent deve restituire sempre STATUS_SUCCESS.
Commenti
Il sottosistema WSK chiama la funzione di callback dell'evento WskAbortEvent dell'applicazione WskAbortEvent solo quando le condizioni seguenti sono vere:
- L'applicazione WSK ha creato un socket in ascolto con modalità di accettazione condizionale abilitata.
- Una richiesta di connessione in ingresso è stata ricevuta nel socket di ascolto e il sottosistema WSK ha chiamato la funzione di callback dell'evento WskInspectEvent dell'applicazione WskInspectEvent .
- L'applicazione WSK ha restituito WskInspectPend o WskInspectAccept dalla relativa funzione di callback dell'evento WskAbortEvent per la richiesta di connessione in ingresso.
- La richiesta di connessione in ingresso è stata eliminata in locale o in remoto prima di essere completamente stabilita.
Se l'applicazione WSK chiama la funzione WskInspectComplete in una richiesta di connessione in ingresso interrotta, la connessione non verrà stabilita anche se WskInspectAccept viene specificato nel parametro Action .
Un'applicazione WSK può abilitare la modalità di accettazione condizionale in un socket in ascolto abilitando l'opzione socket SO_CONDITIONAL_ACCEPT . Per altre informazioni sull'accettazione condizionale delle connessioni in ingresso, vedere Ascolto e accettazione di Connections in ingresso.
Il sottosistema WSK chiama la funzione di callback dell'evento WskAbortEvent dell'applicazione WskAbortEvent in IRQL <= DISPATCH_LEVEL.
La funzione di callback dell'evento WskAbortEvent dell'applicazione WskAbortEvent non deve attendere il completamento di altre richieste WSK nel contesto delle funzioni di completamento o callback degli eventi WSK. Il callback può avviare altre richieste WSK (presupponendo che non spenda troppo tempo in DISPATCH_LEVEL), ma non deve attendere il completamento anche quando il callback viene chiamato in IRQL = PASSIVE_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Windows |
| Intestazione | wsk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |