GetCurrentThreadEffectiveToken function
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.
Syntax
FORCEINLINE HANDLE GetCurrentThreadEffectiveToken(void);
Parameters
This function has no parameters.
Return value
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.
A thread can create a standard handle that is valid in the context of other processes and can be inherited by other processes. To create this standard handle, call the DuplicateHandle function and specify the pseudo-handle as the source handle.
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. If you call DuplicateHandle to duplicate the pseudo-handle, however, you must close the duplicate handle .
Requirements
|
Header |
|
|---|
See also