FwpsOpenToken0-Funktion (fwpsk.h)

  • Artikel

Die FwpsOpenToken0-Funktion öffnet ein Zugriffstoken.

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

 

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 die Filter-Engine. Ein Legendentreiber ruft die FwpmEngineOpen0-Funktion auf, um eine Sitzung für die Filter-Engine zu öffnen.

[in] modifiedId

Gibt eine LUID an, die sich bei jeder Änderung des Tokens ändert. 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 auf das Zugriffstoken angibt. Diese angeforderten Zugriffstypen werden mit der dacl (Discretionary Access Control List) 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 status Codes
 Ein Fehler ist aufgetreten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 7.
Zielplattform Universell
Header fwpsk.h (include Fwpsk.h)
IRQL <= PASSIVE_LEVEL

Weitere Informationen

FwpmEngineOpen0