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.
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 |
|---|---|
|
Ein Umleitungshandle wurde erfolgreich zurückgegeben. Die Variable, auf die der redirectHandle-Parameter verweist, enthält das Handle. |
|
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 |