FwpsRedirectHandleCreate0-Funktion (fwpsk.h)

Die FwpsRedirectHandleCreate0-Funktion erstellt ein Handle, das Verbindungsumleitungsfunktionen verwenden können, um Verbindungen an einen lokalen Prozess umzuleiten. Weitere Informationen zur Umleitung finden Sie unter Verwenden der Bindung oder der Verbindungsumleitung.

HinweisFwpsRedirectHandleCreate0 ist eine bestimmte Version von FwpsRedirectHandleCreate. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

 

Syntax

NTSTATUS FwpsRedirectHandleCreate0(
  const GUID *providerGuid,
  UINT32     flags,
  HANDLE     *redirectHandle
);

Parameter

providerGuid

Die Anbieter-GUID.

flags

Reserviert. Auf NULL festlegen.

redirectHandle

Ein Zeiger auf die Variable, die das Handle empfängt.

Rückgabewert

Die FwpsRedirectHandleCreate0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Ein Umleitungshandle wurde erfolgreich zurückgegeben. Die Variable, auf die der redirectHandle-Parameter verweist, enthält das Handle.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber ruft die Funktion FwpsRedirectHandleCreate0 auf, um ein Handle zu erstellen, das zum Umleiten von Verbindungen verwendet werden kann.

Weitere Informationen zur Umleitung finden Sie unter Verwenden der Bindung oder der Verbindungsumleitung.

Ihr Legendentreiber sollte fwpsRedirectHandleCreate0 einmal aufrufen und das Handle zwischenspeichern, damit es das Handle wiederverwenden kann.

Bevor eine Verbindungsumleitungs-Legende (Application Layer Enforcement, ALE) Verbindungen zu einem lokalen Prozess umleiten kann, muss ein Umleitungshandle mit der Funktion FwpsRedirectHandleCreate0 abgerufen und das Handle in die FWPS_CONNECT_REQUEST0-Struktur eingefügt werden. Die Legende ändert die Struktur in der klassifizierenFn für die ALE-Verbindungsumleitungsebenen.

Nachdem ein Legendentreiber die Verwendung eines Umleitungshandles abgeschlossen hat, muss er die FwpsRedirectHandleDestroy0-Funktion aufrufen, um den Handle zu zerstören.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Universell
Header	fwpsk.h (include fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

klassifizierenFn