THREAD SUSPEND statement

Purpose | Suspend execution of a Windows thread.
Syntax | THREAD SUSPEND hThread TO lResult&

Remarks

THREAD SUSPEND adds 1 to the suspend count of the thread specified by hThread (see THREAD CREATE). If it succeeds, the lResult& value is the thread's previous suspend count; otherwise, it is -1. A thread is always suspended if it has a suspend count of 1 or higher.

To decrement the suspend count of a thread, use the THREAD RESUME statement. A suspended thread will only resume execution when its suspend count is decremented to 0.

Restrictions | The THREAD SUSPEND statement generates no run-time errors; all exceptions are reported in the return value lResult&. A thread ID cannot be used interchangeably with a thread handle. A thread can suspend itself by incrementing its own suspend count.
See also | FUNCTION/END FUNCTION, THREAD CLOSE, THREAD Code Group, THREAD CREATE, THREAD Object, THREAD RESUME, THREAD STATUS, THREADCOUNT, THREADED, THREADID