Returns information about a thread, including such items as priority, exception handler, containing process, and execution state.

BOOLEAN GetRtThreadInfo(
    RTHANDLE hThread,             // handle for thread
    LPTHREADINFO_SNAPSHOT lpInfo  // pointer to THREADINFO_SNAPSHOT structure
);

Parameters

hThread

Handle for the thread whose information is requested.

lpInfo

Pointer to the THREADINFO_SNAPSHOT structure where the thread information is to be stored.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_BAD_ADDR 0x800F

lpInfo does not refer to a writeable area of sufficient size to receive the data.

Requirements