FwpsOpenToken0-Funktion (fwpsk.h)

2025-02-07

Die FwpsOpenToken0--Funktion öffnet ein Zugriffstoken.

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

Syntax

NTSTATUS FwpsOpenToken0(
  [in]  IN HANDLE  engineHandle,
  [in]  IN LUID    modifiedId,
  [in]  IN DWORD   desiredAccess,
  [out] OUT HANDLE *accessToken
);

Parameter

[in] engineHandle

Ein Handle für eine geöffnete Sitzung für das Filtermodul. Ein Popuptreiber ruft die FwpmEngineOpen0--Funktion auf, um eine Sitzung für das Filtermodul zu öffnen.

[in] modifiedId

Gibt eine LUID- an, die bei jeder Änderung des Tokens geändert wird. Eine Anwendung kann diesen Wert als Test verwenden, ob sich ein Sicherheitskontext seit seiner letzten Verwendung geändert hat.

[in] desiredAccess

ACCESS_MASK Struktur, die die angeforderten Zugriffstypen für das Zugriffstoken angibt. Diese angeforderten Zugriffstypen werden mit der diskretionären Zugriffssteuerungsliste (DACL-) des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.

[out] accessToken

Zeiger auf eine vom Aufrufer zugewiesene Variable, die ein Handle für das neu geöffnete Zugriffstoken empfängt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Das Zugriffstoken wurde erfolgreich geöffnet.
Andere Statuscodes	Fehler.

Bemerkungen

Der Prozess, der fwpsopentoken0 aufruft, muss die SE_DEBUG_NAME Berechtigung im Prozesstoken aktiviert haben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 7.
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
IRQL-	<= PASSIVE_LEVEL

Siehe auch

FwpmEngineOpen0