PFN_WSK_ABORT_EVENT funzione di callback (wsk.h)

Articolo
02/07/2025

Il WskAbortEvent funzione di callback dell'evento 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 su 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 di un'applicazione WskAbortEvent WskAbortEvent deve restituire sempre STATUS_SUCCESS.

Osservazioni

Il sottosistema WSK chiama la WskAbortEvent di un'applicazione WskAbortEvent funzione di callback degli eventi solo quando le condizioni seguenti sono vere:

L'applicazione WSK ha creato un socket in ascolto con la modalità di accettazione condizionale abilitata.
È stata ricevuta una richiesta di connessione in ingresso sul 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 dal relativo WskAbortEvent funzione di callback dell'evento per la richiesta di connessione in ingresso.
La richiesta di connessione in ingresso è stata eliminata in locale o in remoto prima di essere stabilita completamente.

Quando il sottosistema WSK chiama il WskAbortEvent di un'applicazione WskAbortEvent funzione di callback degli eventi, l'applicazione deve terminare l'ispezione per la richiesta di connessione in ingresso. La richiesta di connessione viene identificata dal contenuto della struttura WSK_INSPECT_ID a cui punta il parametro InspectID.

Se l'applicazione WSK chiama la funzione WskInspectComplete su una richiesta di connessione in ingresso interrotta, la connessione non verrà stabilita anche se WskInspectAccept è specificato nel parametro action.

Un'applicazione WSK può abilitare la modalità di accettazione condizionale in un socket di ascolto abilitando l'opzione socket SO_CONDITIONAL_ACCEPT. Per altre informazioni sull'accettazione condizionale delle connessioni in ingresso, vedere In ascolto e accettazione di connessioni in ingresso.

Il sottosistema WSK chiama la funzione di callback di un'applicazione WSK WskAbortEvent in IRQL <= DISPATCH_LEVEL.

Il WskAbortEvent di un'applicazione WskAbortEvent funzione di callback degli eventi non deve attendere il completamento di altre richieste WSK nel contesto delle funzioni di completamento WSK o callback degli eventi. 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Finestre
intestazione	wsk.h (include Wsk.h)
IRQL	<= DISPATCH_LEVEL