|
Purpose |
Retrieve the Status of a Windows thread. |
|
Syntax |
THREAD STATUS hThread TO lResult& |
|
Remarks |
THREAD STATUS assigns the status of the thread identified by the DWORD value in hThread (see THREAD CREATE) to lResult&. If the function fails, lResult& is set to zero. If the thread is still running, the system value &H103 is assigned. If the thread has terminated and the thread handle has not yet been closed, the return value from the thread Function is assigned to lResult&. To wait for one or more threads to complete execution, use the WaitForSingleObject or WaitForMultipleObjects API functions - see THREAD CLOSE for more information. The number of currently running threads in a module can be determined with the THREADCOUNT function. |
|
Restrictions |
The THREAD STATUS statement generates no run-time errors; all exceptions are reported in the return value lResult&. A thread ID cannot be used in place of a thread handle. |
|
See also |
FUNCTION/END FUNCTION, THREAD CLOSE, THREAD Code Group, THREAD CREATE, THREAD Object, THREAD RESUME, THREAD SUSPEND, THREADCOUNT, THREADED, THREADID |