Freigeben über

FwpsOpenToken0-Funktion (fwpsu.h)

  • Artikel

Öffnet ein Zugriffstoken.

Hinweis

FwpsOpenToken0 ist eine bestimmte Version von FwpsOpenToken. Weitere Informationen finden Sie unter Versionsunabhängige WFP-Namen und für bestimmte Versionen von Windows.

Syntax

DWORD FwpsOpenToken0(
  HANDLE engineHandle,
  LUID   modifiedId,
  DWORD  desiredAccess,
  HANDLE *accessToken
);

Parameter

engineHandle

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

modifiedId

Gibt eine LUID an, die sich jedes Mal ändert, wenn das Token geändert wird. Eine Anwendung kann diesen Wert als Test verwenden, ob sich ein Sicherheitskontext seit seiner letzten Verwendung geändert hat.

desiredAccess

ACCESS_MASK Struktur, die die angeforderten Zugriffstypen auf 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.

accessToken

Zeiger auf eine vom Aufrufer zugewiesene Variable, die ein Handle auf 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 Ein Fehler ist aufgetreten.

Anforderungen

Anforderung Wert
Header fwpsu.h