WSK_INSPECT_ID struttura (wsk.h)

Articolo
08/08/2023

La struttura WSK_INSPECT_ID specifica un identificatore per una richiesta di connessione in ingresso in un socket in ascolto.

Sintassi

typedef struct _WSK_INSPECT_ID {
  ULONG_PTR Key;
  ULONG     SerialNumber;
} WSK_INSPECT_ID, *PWSK_INSPECT_ID;

Members

Key

Chiave assegnata alla richiesta di connessione in ingresso.

SerialNumber

Numero di serie assegnato alla richiesta di connessione in ingresso.

Commenti

Il sottosistema WSK passa un puntatore a una struttura WSK_INSPECT_ID a una funzione di callback dell'evento WskInspectEvent dell'applicazione WskInspectEvent ogni volta che una richiesta di connessione in ingresso arriva su un socket di ascolto con modalità di accettazione condizionale abilitata. Il contenuto della struttura WSK_INSPECT_ID identifica in modo univoco la richiesta di connessione in ingresso.

Se l'applicazione WSK restituisce WskInspectPend da una chiamata alla relativa funzione di callback dell'evento WskInspectEvent , l'applicazione deve prima copiare il contenuto della struttura WSK_INSPECT_ID fornita dal sottosistema WSK nella propria struttura WSK_INSPECT_ID. L'applicazione WSK passa quindi un puntatore alla struttura WSK_INSPECT_ID alla funzione WskInspectComplete al termine dell'ispezione.

Se la richiesta di connessione in ingresso viene eliminata dal sistema remoto mentre un'operazione di controllo è in sospeso, il sottosistema WSK chiama la funzione di callback dell'applicazione WskAbortEvent con un puntatore a una struttura WSK_INSPECT_ID che identifica la richiesta eliminata. L'applicazione WSK usa il contenuto di questa struttura WSK_INSPECT_ID per determinare quale ispezione di una richiesta di connessione in ingresso deve essere terminata. L'applicazione WSK deve confrontare il contenuto delle strutture WSK_INSPECT_ID per verificare la corrispondenza. I valori effettivi dei membri della struttura sono irrilevanti.

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.