Thread handles and thread IDs (127992)



The information in this article applies to:

  • Microsoft Win32 Application Programming Interface (API), when used with:
    • the operating system: Microsoft Windows 95
    • the operating system: Microsoft Windows 98
    • the operating system: Microsoft Windows Millennium Edition
    • the operating system: Microsoft Windows NT 3.5
    • the operating system: Microsoft Windows NT 3.51
    • the operating system: Microsoft Windows NT 4.0
    • the operating system: Microsoft Windows 2000
    • the operating system: Microsoft Windows XP

This article was previously published under Q127992

SUMMARY

The CreateThread() API is used to create threads. The API returns both a thread handle and a thread identifier (ID). The thread handle has full access rights to the thread object created. The thread ID uniquely identifies the thread at the system level while the thread is running. This relationship is similar to that of the process handle and the process ID. The thread ID can be recycled after the thread exits or is terminated.

On Windows 95, Windows 98, and Windows NT, there is no way to obtain the thread handle from the thread ID. On these operating systems, a thread handle can be shared with another process by using the DuplicateHandle() function.

On Windows Millennium Edition, Windows 2000, and Windows XP, the OpenThread() function can be used to obtain a thread handle based on the thread ID.

The APIs that take a thread handle can be used to suspend and resume a thread, adjust the priority of a thread, read and write a thread's registers, limit a thread to a set of processors, terminate a thread, and other actions. Performing any one of these operations on a thread without the knowledge of the owning process is dangerous, and may cause the process to fail.

NOTE: On all Win32 operating systems, you can also take full control of the application by calling DebugActiveProcess(). Debuggers receive the thread handles for a process when the threads are created. These handles have THREAD_GET_CONTEXT, THREAD_SET_CONTEXT, and THREAD_SUSPEND_RESUME access to the thread.

Modification Type:MinorLast Reviewed:9/27/2004
Keywords:kbAPI kbinfo kbKernBase kbThread KB127992 kbAudDeveloper