PFN_WSK_CONNECT Rückruffunktion (wsk.h)

Artikel
02/07/2025

Die WskConnect--Funktion verbindet einen verbindungsorientierten oder Streamsocket mit einer Remote-Transportadresse.

Syntax

PFN_WSK_CONNECT PfnWskConnect;

NTSTATUS PfnWskConnect(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR RemoteAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

Parameter

[in] Socket

Ein Zeiger auf eine WSK_SOCKET-Struktur, die das Socketobjekt für den Socket angibt, der mit einer Remotetransportadresse verbunden ist.

[in] RemoteAddress

Ein Zeiger auf eine Struktur, die die Remotetransportadresse angibt, mit der der Socket verbunden werden soll. Dieser Zeiger muss ein Zeiger auf den spezifischen SOCKADDR-Strukturtyp sein, der der Adressfamilie entspricht, die die WSK-Anwendung beim Erstellen des Sockets angegeben hat.

Flags

Dieser Parameter ist für die Systemverwendung reserviert. Eine WSK-Anwendung muss diesen Parameter auf Null festlegen.

[in, out] Irp

Ein Zeiger auf ein vom Aufrufer zugewiesenes IRP, das vom WSK-Subsystem verwendet wird, um den Verbindungsvorgang asynchron abzuschließen. Weitere Informationen zur Verwendung von IRPs mit WSK-Funktionen finden Sie unter Verwenden von IRPs mit Winsock Kernel Functions.

Rückgabewert

WskConnect- gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Socket wurde erfolgreich mit der Remotetransportadresse verbunden. Das IRP wird mit dem Erfolgsstatus abgeschlossen.
STATUS_PENDING	Das WSK-Subsystem konnte den Socket nicht sofort verbinden. Das WSK-Subsystem schließt das IRP ab, nachdem es den Socket mit der Remote-Transportadresse verbunden hat. Der Status des Verbindungsvorgangs wird im feld IoStatus.Status IRP zurückgegeben.
STATUS_FILE_FORCED_CLOSED	Der Socket ist nicht mehr funktionsfähig. Das IRP wird mit dem Fehlerstatus abgeschlossen. Die WSK-Anwendung muss die WskCloseSocket- Funktion aufrufen, um den Socket so schnell wie möglich zu schließen.
Andere Statuscodes	Fehler. Das IRP wird mit dem Fehlerstatus abgeschlossen.

Bemerkungen

Eine WSK-Anwendung kann die WskConnect--Funktion nur für einen verbindungsorientierten oder Streamsocket aufrufen, den die Anwendung zuvor an eine lokale Transportadresse gebunden hat, indem sie die WskBind--Funktion aufruft.

Wenn WskConnect- erfolgreich für einen Datenstromsocket aufgerufen wird, wird der Socket für einen verbindungsorientierten Ablauf zugesichert und ruft möglicherweise keine Überwachungssocketfunktionen mehr auf.

Eine WSK-Anwendung kann einen verbindungsorientierten Socket in einem einzelnen Funktionsaufruf erstellen, binden und verbinden, indem die WskSocketConnect--Funktion aufgerufen wird, anstatt die WskSocket--Funktion, die WskBind--Funktion und dann die WskConnect-Funktion aufzurufen. Es wird empfohlen, die WskSocketConnect--Funktion aufzurufen, es sei denn, die WSK-Anwendung muss eine Socketoption festlegen oder einen E/A-Steuerungsvorgang vor dem Binden oder Verbinden des Sockets ausstellen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Universal
Header-	wsk.h (include Wsk.h)
IRQL-	<= DISPATCH_LEVEL