FwpsOpenToken0 function

The FwpsOpenToken0 function opens an access token.

Note  FwpsOpenToken0 is a specific version of FwpsOpenToken. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

 

Syntax

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

Parameters

engineHandle

A handle for an open session to the filter engine. A callout driver calls the FwpmEngineOpen0 function to open a session to the filter engine.

modifiedId

Specifies an LUID that changes each time the token is modified. An application can use this value as a test of whether a security context has changed since it was last used.

desiredAccess

ACCESS_MASK structure specifying the requested types of access to the access token. These requested access types are compared with the token's discretionary access-control list (DACL) to determine which accesses are granted or denied.

accessToken

Pointer to a caller-allocated variable that receives a handle to the newly opened access token.

Return Value

The FwpsOpenToken0 function returns one of the following NTSTATUS codes.

Return code Description
STATUS_SUCCESS
The access token was successfully opened.
Other status codes
An error occurred.

Requirements

   
Minimum supported client Available starting with Windows 7.
Target Platform Universal
Header fwpsk.h (include Fwpsk.h)
IRQL "<= PASSIVE_LEVEL"

See Also

FwpmEngineOpen0