FwpsOpenToken0 function (fwpsk.h)

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]  IN HANDLE  engineHandle,
  [in]  IN LUID    modifiedId,
  [in]  IN DWORD   desiredAccess,
  [out] OUT HANDLE *accessToken
);

Parameters

[in] 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.

[in] 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.

[in] 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.

[out] 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

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

See also

FwpmEngineOpen0