FwpsOpenToken0 function (fwpsk.h)

  • Article

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.

Remarks

The process that calls fwpsopentoken0 must have the SE_DEBUG_NAME privilege enabled in its process token.

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