This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for

This function returns a pseudohandle for the current thread.


HANDLE GetCurrentThread(void);



Return Value

Pseudohandle for the current thread.


A pseudohandle is a special constant that is interpreted as the current thread handle. The calling thread can use this handle to specify itself when 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.

The pseudohandle does not need to be closed when it is no longer needed.

Calling the CloseHandlefunction with this handle has no effect.


Header kfuncs.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also