Skip to content

Latest commit

 

History

History
81 lines (60 loc) · 3.19 KB

nf-processthreadsapi-getcurrentthreadeffectivetoken.md

File metadata and controls

81 lines (60 loc) · 3.19 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:processthreadsapi.GetCurrentThreadEffectiveToken
GetCurrentThreadEffectiveToken function (processthreadsapi.h)
Retrieves a pseudo-handle that you can use as a shorthand way to refer to the token that is currently in effect for the thread, which is the thread token if one exists and the process token otherwise.
GetCurrentThreadEffectiveToken
GetCurrentThreadEffectiveToken function [Security]
processthreadsapi/GetCurrentThreadEffectiveToken
security.getcurrentthreadeffectivetoken
security\getcurrentthreadeffectivetoken.htm
processthreadsapi
794E9086-17E7-4520-AB30-63DF00FF7AA4
12/05/2018
GetCurrentThreadEffectiveToken, GetCurrentThreadEffectiveToken function [Security], processthreadsapi/GetCurrentThreadEffectiveToken, security.getcurrentthreadeffectivetoken
processthreadsapi.h
Windows
Windows 8 [desktop apps | UWP apps]
Windows Server 2012 [desktop apps | UWP apps]
Windows
19H1
GetCurrentThreadEffectiveToken
processthreadsapi/GetCurrentThreadEffectiveToken
c++
APIRef
kbSyntax
HeaderDef
processthreadsapi.h
GetCurrentThreadEffectiveToken

GetCurrentThreadEffectiveToken function

-description

Retrieves a pseudo-handle that you can use as a shorthand way to refer to the token that is currently in effect for the thread, which is the thread token if one exists and the process token otherwise.

-returns

A pseudo-handle that you can use as a shorthand way to refer to the token that is currently in effect for the thread.

-remarks

A pseudo-handle is a special constant that can function as the effective token for the current thread. The calling thread can use a pseudo-handle to specify the effective token for that thread whenever a token handle is required. Child processes do not inherit pseudo-handles.

Starting in Windows 8, this pseudo-handle has only TOKEN_QUERY and TOKEN_QUERY_SOURCE access rights.

The pseudo-handle cannot be duplicated by the DuplicateHandle function or the DuplicateToken function.

You do not need to close the pseudo-handle when you no longer need it. If you call the CloseHandle function with a pseudo-handle, the function has no effect.

-see-also

Access Rights for Access-Token Objects

GetCurrentProcessToken

GetCurrentThreadToken