FwpsQueryConnectionSioFormatRedirectRecords0-Funktion (fwpsk.h)

Artikel
02/26/2024

Die FwpsQueryConnectionSioFormatRedirectRecords0-Funktion gibt die Verbindungsumleitungsdatensätze für eine umgeleitete Verbindung zurück. Weitere Informationen zur Umleitung finden Sie unter Using Bind or Connect Redirection.For more information about redirection, see Using Bind or Connect Redirection.

HinweisFwpsQueryConnectionSioFormatRedirectRecords0 ist eine bestimmte Version von FwpsQueryConnectionSioFormatRedirectRecords. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

Syntax

NTSTATUS FwpsQueryConnectionSioFormatRedirectRecords0(
  [in]            HANDLE  RedirectRecords,
  [out, optional] PVOID   OutputBuffer,
  [in]            SIZE_T  OutputBufferLength,
  [out, optional] PSIZE_T BytesTransferred
);

Parameter

[in] RedirectRecords

Die Umleitungsdatensätze behandeln, dass die ALE_CONNECT_REDIRECT-Beschriftungsfunktion im inMetaValues-Parameter ihrer klassifizierenFn-Funktion empfangen hat. Dieses Handle befindet sich im redirectRecords-Element der FWPS_INCOMING_METADATA_VALUES0-Struktur .

Ein WFP-Umleitungsdatensatz ist ein Puffer von undurchsichtigen Daten, den WFP für eine ausgehende Proxyverbindung festlegen muss, damit die umgeleitete Verbindung und die ursprüngliche Verbindung logisch miteinander verknüpft sind.

[out, optional] OutputBuffer

Ein Zeiger auf einen Ausgabepuffer, der die Umleitungsdatensätze empfängt. Der Puffer muss mit einem Zeiger ausgerichtet sein.

[in] OutputBufferLength

Die Größe des Ausgabepuffers in Bytes.

[out, optional] BytesTransferred

Ein Zeiger auf eine Variable, die die Anzahl der übertragenen Bytes empfängt. Wenn der Rückgabewert STATUS_BUFFER_TOO_SMALL ist, empfängt dieser Parameter die erforderliche Puffergröße.

Rückgabewert

Gibt einen NTSTATUS-Wert wie einen der folgenden zurück.

Rückgabecode	Beschreibung
STATUS_BUFFER_TOO_SMALL	Der Ausgabepuffer war zu klein, um alle zu übertragenden Bytes zu enthalten. Fehler bei der Datenübertragung, und die erforderliche Puffergröße finden Sie im BytesTransferred-Parameter .
STATUS_NOT_FOUND	Der RedirectRecords-Parameter war NULL.

Hinweise

Die FwpsQueryConnectionSioFormatRedirectRecords0-Funktion gilt nur für lokale Proxys.

Weitere Informationen zur Umleitung finden Sie unter Using Bind or Connect Redirection.For more information about redirection, see Using Bind or Connect Redirection.

Die Funktion FwpsQueryConnectionSioFormatRedirectRecords0 ist für die Verwendung von einem WFP-Verbindungsumleitungs-Legendentreiber konzipiert, der die umgeleitete Verbindung erst akzeptiert, wenn überprüft wurde, ob eine Verbindung mit dem tatsächlichen Remoteendpunkt hergestellt werden kann. Dazu schreibt der Legendentreiber die umgeleitete Verbindungsanforderung auf der FWPS_LAYER_ALE_CONNECT_REDIRECT_V4- oder FWPS_LAYER_ALE_CONNECT_REDIRECT_V6-Ebene und ruft FwpsQueryConnectionSioFormatRedirectRecords0 auf, um die Verbindungsumleitungsdatensätze abzurufen, die der Legendentreiber dann an den Proxy sendet, der in einem Aufruf von SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS verwendet werden soll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Universell
Header	fwpsk.h (include Fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL