PFN_WSK_LISTEN Rückruffunktion (wsk.h)

Artikel
03/01/2024

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
STATUS_SUCCESS	Der Streamsocket hat erfolgreich auf eine eingehende Verbindung lauscht. Die IRP wird erfolgreich status abgeschlossen.
STATUS_PENDING	Das IRP wurde vom WSK-Subsystem in die Warteschlange gestellt, das auf eine eingehende Verbindung im Streamsocket wartet.
STATUS_FILE_FORCED_CLOSED	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.
Andere status Codes	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

Weitere Informationen

WSK_PROVIDER_STREAM_DISPATCH