History of terminateThread

== Syntax ==

bool terminateThread(int hThread)

== Arguments ==

:hThread

:: Specifies the handle of the thread which we wish to terminate, or 0 to terminate all current worker threads.

== Return ==

Returns true if all specified threads have terminated, or false if an error occurred.

== Description ==

Use this function to terminate one or all worker threads that were created by calling triggerThread. To terminate one particular thread, set the hThread parameter to the value of the thread handle that was returned by the call to triggerThread. To terminate all current worker threads, set the hThread parameter to 0.

Note: This API can be dangerous to use, since forcibly terminating a thread can result in failure to release resources owned by the thread, and DLLs attached to the thread are not notified that the thread is terminating. Use this API only when absolutely necessary. For more details, see the documentation of the Windows [TerminateThread API].

== Comments ==

The current implementation of terminateThread recognizes only a parameter of 0 to terminate all threads; you cannot specify a thread handle to terminate a specific thread.

== Example ==

See the example in triggerThread.

== See Also ==

System Functions, Multithreading Functions, countProcessors, triggerThread, waitForThread, isThreadActive, getThreadRetVal