PFN_WSK_LISTEN Rückruffunktion (wsk.h)
Die WskListen-Funktion ermöglicht es einem Streamsocket, auf eingehende Verbindungen an der gebundenen Adresse des Sockets zu lauschen.
Syntax
PFN_WSK_LISTEN PfnWskListen;
NTSTATUS PfnWskListen(
[in] PWSK_SOCKET Socket,
[in, out] PIRP Irp
)
{...}
Parameter
[in] Socket
Ein Zeiger auf eine WSK_SOCKET-Struktur , die das Socketobjekt für den Streamsocket angibt, der auf eine eingehende Verbindung lauscht. Dieser Socket muss zuvor durch Aufrufen von WskBind an eine lokale Transportadresse gebunden worden sein.
[in, out] Irp
Ein Zeiger auf einen vom Aufrufer zugewiesenen IRP, den das WSK-Subsystem verwendet, um den Lauschvorgang asynchron abzuschließen. Weitere Informationen zur Verwendung von IRPs mit WSK-Funktionen finden Sie unter Verwenden von IRPs mit Winsock-Kernelfunktionen.
Rückgabewert
WskListen gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Streamsocket hat erfolgreich auf eine eingehende Verbindung lauscht. Die IRP wird erfolgreich status abgeschlossen. |
|
Das IRP wurde vom WSK-Subsystem in die Warteschlange gestellt, das auf eine eingehende Verbindung im Streamsocket wartet. |
|
Der Socket ist nicht mehr funktionsfähig. Die IRP wird mit einem Fehler status abgeschlossen. Die WSK-Anwendung muss die WskCloseSocket-Funktion aufrufen, um den Socket so schnell wie möglich zu schließen. |
|
Ein Fehler ist aufgetreten. Die IRP wird mit einem Fehler status abgeschlossen. |
Hinweise
Eine WSK-Anwendung kann die WskListen-Funktion nur für einen Streamsocket aufrufen, den die Anwendung zuvor durch Aufrufen der WskBind-Funktion an eine lokale Transportadresse gebunden hat. Nachdem WskListen erfolgreich für einen Streamsocket aufgerufen wurde, wird der Socket zu einem überwachenden Socketflow committet und kann keine verbindungsorientierten Socketfunktionen mehr aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 |
| Zielplattform | Universell |
| Header | wsk.h (einschließen von Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |