PFN_WSK_GET_REMOTE_ADDRESS Rückruffunktion (wsk.h)

Die WskGetRemoteAddress-Funktion ruft die Remotetransportadresse eines verbindungsorientierten oder Stream-Sockets ab.

Syntax

PFN_WSK_GET_REMOTE_ADDRESS PfnWskGetRemoteAddress;

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

Parameter

[in] Socket

Ein Zeiger auf eine WSK_SOCKET Struktur, die das Socketobjekt für den Socket angibt, der abgefragt wird.

[out] RemoteAddress

Ein Zeiger auf einen zugewiesenen Anruferpuffer, der die Remotetransportadresse für den Socket empfängt. Der Puffer muss sich im nicht seitenseitigen Arbeitsspeicher befinden. Der Puffer muss auch groß genug sein, um den spezifischen SOCKADDR-Strukturtyp zu enthalten, der der Adressfamilie entspricht, die die WSK-Anwendung beim Erstellen des Sockets angegeben hat.

Für einen verbindungsorientierten Socket, den die WSK-Anwendung in einem Überwachungs socket akzeptiert hat, entspricht die Adressfamilie der Adressfamilie, die die WSK-Anwendung beim Erstellen des Überwachungs sockets angegeben hat.

[in, out] Irp

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

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS
Die Remotetransportadresse für den Socket wurde erfolgreich abgerufen. Der IRP wird mit dem Erfolgsstatus abgeschlossen.
STATUS_PENDING
Das WSK-Subsystem konnte die Remotetransportadresse für den Socket nicht sofort abrufen. Das WSK-Subsystem wird das IRP abgeschlossen, nachdem er die Remotetransportadresse für den Socket abgerufen hat. Der Status des Abrufvorgangs wird im IoStatus.Status-Feld des IRP zurückgegeben.
STATUS_INVALID_DEVICE_STATE
Der Socket ist nicht mit einer Remotetransportadresse verbunden. Der IRP wird mit dem Fehlerstatus abgeschlossen.
STATUS_FILE_FORCED_CLOSED
Der Socket ist nicht mehr funktionsfähig. Der 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
Ein Fehler ist aufgetreten. Der IRP wird mit dem Fehlerstatus abgeschlossen.

Bemerkungen

Eine WSK-Anwendung kann die WskGetRemoteAddress-Funktion nur auf einem Verbindungs- oder Stream-Socket aufrufen, der mit einer Remotetransportadresse verbunden wurde. Ein Stream-Socket ist mit einer Remotetransportadresse verbunden, indem die WskConnect-Funktion aufgerufen wird. Ein verbindungsorientierter Socket ist mit einer Remotetransportadresse auf eine der folgenden Arten verbunden:

  • Die WSK-Anwendung ruft die WskConnect-Funktion auf.
  • Die WSK-Anwendung erstellt, bindet und verbindet den Socket durch Aufrufen der WskSocketConnect-Funktion .
  • Das WSK-Subsystem verbindet den Socket, wenn die WSK-Anwendung eine eingehende Verbindungsanforderung in einem Überwachungs socket akzeptiert.
Wenn die WskGetRemoteAddress-Funktion STATUS_PENDING zurückgibt, muss der Puffer, auf den der RemoteAddress-Parameter verweist, gültig bleiben, bis das IRP abgeschlossen ist. Wenn die WSK-Anwendung den Puffer mit einer der ExAllocateXxx-Funktionen zugewiesen hat, kann der Speicher mit der entsprechenden ExFreeXxx-Funktion erst frei werden, wenn die IRP abgeschlossen ist. Wenn die WSK-Anwendung den Puffer auf dem Stapel zugewiesen hat, kann sie nicht von der Funktion zurückgegeben werden, die die WskGetRemoteAddress-Funktion aufruft, bis nach Abschluss des IRP.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und späteren Versionen der Windows-Betriebssysteme.
Zielplattform Universell
Header wsk.h (einschließlich Wsk.h)
IRQL <= DISPATCH_LEVEL

Weitere Informationen

SOCKADDR

WSK_PROVIDER_CONNECTION_DISPATCH

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskAccept

WskAcceptEvent

WskBind

WskCloseSocket

WskConnect

WskGetLocalAddress

WskSocketConnect