PFN_WSK_LISTEN funzione di callback (wsk.h)
La funzione WskListen consente a un socket di flusso di ascoltare le 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 chiamante allocato IRP usato dal sottosistema WSK per completare l'operazione di ascolto in modo asincrono. Per altre informazioni sull'uso di IRP con funzioni WSK, vedere Uso di IRP con Funzioni kernel Winsock.
Valore restituito
WskListen restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il socket di flusso è in ascolto per una connessione in ingresso correttamente. L'IRP verrà completato con lo stato di esito positivo. |
|
L'IRP è stato accodato dal sottosistema WSK, in attesa di una connessione in ingresso nel socket di flusso. |
|
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. |
|
Si è verificato un errore. L'IRP verrà completato con lo stato di errore. |
Commenti
Un'applicazione WSK può chiamare la funzione WskListen solo in un socket di flusso associato in precedenza a un indirizzo di trasporto locale chiamando la funzione WskBind . Una volta che WskListen viene chiamato correttamente in 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 versione 1703 |
| Piattaforma di destinazione | Universale |
| Intestazione | wsk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |