Hardware Dev Center

Expand Minimize

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 NTAPI NTAPI FwpsOpenToken0(
  _In_  HANDLE engineHandle,
  _In_  LUID   modifiedId,
  _In_  DWORD  desiredAccess,
  _Out_ HANDLE *accessToken
);

Parameters

engineHandle [in]

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

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

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

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 codeDescription
STATUS_SUCCESS

The access token was successfully opened.

Other status codes

An error occurred.

 

Requirements

Target platform

Universal

Version

Available starting with Windows 7.

Header

Fwpsk.h (include Fwpsk.h)

IRQL

<= PASSIVE_LEVEL

See also

FwpmEngineOpen0

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft