FwpsRedirectHandleCreate0-Funktion (fwpsk.h)

Artikel
02/07/2025

Die FwpsRedirectHandleCreate0-Funktion erstellt ein Handle, mit dem Verbindungsumleitungsfunktionen Verbindungen zu einem lokalen Prozess umleiten können. Weitere Informationen zur Umleitung finden Sie unter Using Bind or Connect Redirection.

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

Syntax

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

Parameter

providerGuid

Die Anbieter-GUID.

flags

Reserviert. Auf Null festgelegt.

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 die redirectHandle Parameter verweist, auf die das Handle verweist.
Andere Statuscodes	Fehler.

Bemerkungen

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

Weitere Informationen zur Umleitung finden Sie unter Using Bind or Connect Redirection.

Der Popuptreiber sollte FwpsRedirectHandleCreate0 einmal aufrufen und den Handle zwischenspeichern, damit er den Handle wiederverwenden kann.

Bevor eine ALE-Verbindungsumleitungsbeschriftung (Application Layer Enforcement) Verbindungen zu einem lokalen Prozess umleiten kann, muss sie ein Umleitungshandle mit der FwpsRedirectHandleCreate0--Funktion abrufen und das Handle in die FWPS_CONNECT_REQUEST0 Struktur einfügen. Die Legende ändert die Struktur in der klassifizierenFn für die ALE Connect-Umleitungsebenen.

Nachdem ein Popuptreiber ein Umleitungshandle verwendet hat, muss er die FwpsRedirectHandleDestroy0--Funktion aufrufen, um den Handle zu zerstören.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

klassifizierenFn-

Freigeben über