This structure describes an entry from a list that enumerates the threads executing in the system when a snapshot was taken.
At a Glance
| Header file: | Tlhelp32.h |
| Windows CE versions: | 1.0 and later |
Syntax
typedef struct tagTHREADENTRY32{
DWORD dwSize;
DWORD cntUsage;
DWORD th32ThreadID;
DWORD th32OwnerProcessID;
LONG tpBasePri;
LONG tpDeltaPri;
DWORD dwFlags;
DWORD th32AccessKey;
DWORD th32CurrentProcessID;
} THREADENTRY32;
typedef THREADENTRY32 * PTHREADENTRY32;
typedef THREADENTRY32 * LPTHREADENTRY32;
Members
dwSize
Specifies the length, in bytes, of the structure. Before calling the Thread32First function, set this member to sizeof(THREADENTRY32). If you do not initialize dwSize, Thread32First will fail.
cntUsage
Number of references to the thread. A thread exists as long as its usage count is nonzero. As soon as its usage count becomes zero, a thread terminates.
th32ThreadID
Identifier of the thread. This identifier is compatible with the thread identifier returned by the CreateProcess function.
th32OwnerProcessID
Identifier of the process that created the thread. The contents of this member can be used by Win32 API elements.
tpBasePri
Initial priority level assigned to a thread. This member can be one of the following values:
| Value | Description |
| THREAD_PRIORITY_IDLE | Indicates a base priority level of 1 for IDLE_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, or HIGH_PRIORITY_CLASS processes, and a base priority level of 16 for REALTIME_PRIORITY_CLASS processes. |
| THREAD_PRIORITY_LOWEST | Indicates 2 points below normal priority for the priority class. |
| THREAD_PRIORITY_BELOW_NORMAL | Indicates 1 point below normal priority for the priority class. |
| THREAD_PRIORITY_NORMAL | Indicates normal priority for the priority class. |
| THREAD_PRIORITY_ABOVE_NORMAL | Indicates 1 point above normal priority for the priority class. |
| THREAD_PRIORITY_HIGHEST | Indicates 2 points above normal priority for the priority class. |
| THREAD_PRIORITY_TIME_CRITICAL | Indicates a base priority level of 15 for IDLE_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS, or HIGH_PRIORITY_CLASS processes, and a base priority level of 31 for REALTIME_PRIORITY_CLASS processes. |
tpDeltaPri
Change in the priority level of a thread. This value is a signed delta from the base priority level assigned to the thread.
dwFlags
Reserved; do not use.
Remarks
Windows CE supports the following additional members:
| Value | Description |
| th32AccessKey | Array of bits. Each bit signifies permission to see the address space of one process. In the THREADENTRY32 structure, the key contains the bits the thread currently has, thus defining the processes it can currently see. |
| th32CurrentProcessID | Process identifier where the thread is executing. |