GetCurrentProcessToken function (processthreadsapi.h)

Retrieves a pseudo-handle that you can use as a shorthand way to refer to the access token associated with a process.

Syntax

HANDLE GetCurrentProcessToken();

Return value

A pseudo-handle that you can use as a shorthand way to refer to the access token associated with a process.

Remarks

A pseudo-handle is a special constant that can function as the access token for the current process. The calling process can use a pseudo-handle to specify the access token for that process 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.

Requirements

See also

Access Rights for Access-Token Objects

OpenProcessToken