GetCurrentThread

This function returns a pseudohandle for the current thread.

At a Glance

Header file: Kfuncs.h
Versions: 1.0 and later

Syntax

HANDLE GetCurrentThread(void);

Return Values

A pseudohandle for the current thread indicates success.

Remarks

A pseudohandle is a special constant that is interpreted as the current thread handle. The calling thread can use this handle to specify itself whenever a thread handle is required.

This handle has the maximum possible access to the thread object.

The function cannot be used by one thread to create a handle that can be used by other threads to refer to the first thread. The handle is always interpreted as referring to the thread that is using it. A thread can create a “real” handle to itself that can be used by other threads, or inherited by other processes, by specifying the pseudohandle as the source handle in a call to the DuplicateHandle function.

The pseudohandle need not be closed when it is no longer needed. Calling the CloseHandle function with this handle has no effect.

See Also

CloseHandle, GetCurrentProcess, GetCurrentThreadId