Condividi tramite


struttura WSK_INSPECT_ID (wsk.h)

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

Sintassi

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

Membri

Key

Chiave assegnata alla richiesta di connessione in ingresso.

SerialNumber

Numero di serie assegnato alla richiesta di connessione in ingresso.

Osservazioni

Il sottosistema WSK passa un puntatore a una struttura di WSK_INSPECT_ID a un'applicazione WSK WskInspectEvent funzione di callback degli eventi ogni volta che arriva una richiesta di connessione in ingresso su un socket in 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 al relativo WskInspectEvent funzione di callback degli eventi, 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 quando completa l'ispezione.

Se la richiesta di connessione in ingresso viene eliminata dal sistema remoto mentre è in sospeso un'operazione di ispezione, il sottosistema WSK chiama il WskAbortEvent funzione di callback degli eventi 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 di WSK_INSPECT_ID per verificare la presenza di una corrispondenza. I valori effettivi dei membri della struttura sono irrilevanti.

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.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
intestazione wsk.h (include Wsk.h)

Vedere anche

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent