PFN_WSK_LISTEN funzione di callback (wsk.h)

Articolo
02/07/2025

La funzione WskListen consente a un socket di flusso di restare in ascolto delle connessioni in ingresso all'indirizzo associato del socket.

Sintassi

PFN_WSK_LISTEN PfnWskListen;

NTSTATUS PfnWskListen(
  [in]      PWSK_SOCKET Socket,
  [in, out] PIRP Irp
)
{...}

Parametri

[in] Socket

Puntatore a una struttura WSK_SOCKET che specifica l'oggetto socket per il socket di flusso in ascolto di una connessione in ingresso. Questo socket deve essere stato associato in precedenza a un indirizzo di trasporto locale chiamando WskBind.

[in, out] Irp

Puntatore a un IRP allocato dal chiamante usato dal sottosistema WSK per completare l'operazione di ascolto in modo asincrono. Per altre informazioni sull'uso di runtime di integrazione con funzioni WSK, vedere Uso di runtime di integrazione con Funzioni kernel Winsock.

Valore restituito

WskListen restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il socket di flusso è stato in ascolto di una connessione in ingresso. L'IRP verrà completato con lo stato di esito positivo.
STATUS_PENDING	L'IRP è stato accodato dal sottosistema WSK, in attesa di una connessione in ingresso sul socket di flusso.
STATUS_FILE_FORCED_CLOSED	Il socket non è più funzionale. L'IRP verrà completato con lo stato di errore. L'applicazione WSK deve chiamare la funzione WskCloseSocket per chiudere il socket il prima possibile.
Altri codici di stato	Si è verificato un errore. L'IRP verrà completato con lo stato di errore.

Osservazioni

Un'applicazione WSK può chiamare la funzione WskListen solo su un socket di flusso associato in precedenza a un indirizzo di trasporto locale chiamando la funzione WskBind. Quando WskListen viene chiamato correttamente su un socket di flusso, il socket viene eseguito il commit in un flusso socket in ascolto e non può più chiamare funzioni socket orientate alla connessione.