Kills the specified thread, terminating it abnormally and detaching all resources associated with it.
Syntax:
call "CBL_THREAD_KILL" using by value thread-id
Parameters:
|
Using call prototype (see
Key)
|
Picture
|
thread-id
|
cblt-pointer
|
usage pointer.
|
On Entry:
thread-id
|
A pointer to the thread identifier
|
Comments:
This routine can only be used to kill a thread that was created with CBL_THREAD_CREATE, and not threads created in other ways.
If the target thread has already completed, but was not detached, this call simply detaches it and discards any return value.
This call can be used with thread-id set to the current thread. In this case its effect is the same as CBL_THREAD_EXIT with a NULL return value.
Behavior is undefined: