CBL_THREAD_KILL
指定されたスレッドを中断し、スレッドを異常終了させて関連するリソースをすべて解放する。
構文:
call "CBL_THREAD_KILL" using by value thread-id
パラメタ:
| 呼び出しプロトタイプ使用時 ( 説明の読み方) | PIC (32bitシステム) | |
|---|---|---|
| thread-id | cblt-pointer | usage pointer. |
入力パラメタ:
| thread-id | スレッド識別子へのポインタ |
出力パラメタ:
| return-code | 成功したか否かを示す値。詳細は、 「スレッド制御ルーチンのRETURN-CODE値」を参照のこと。 |
説明:
本ルーチンは、CBL_THREAD_CREATEで作成されたスレッドを中断するためにだけ使用でき、それ以外の方法で作成されたスレッドは中断しない。
目標のスレッドがすでに完了しているが切り離されていない場合、本呼出しはスレッドの切離しだけを行い、リターン値を破棄する。
本ルーチンには、現行のスレッドに設定されたthread-id を使用することができる。この場合、その結果はナルリターン値が設定されたCBL_THREAD_EXITと同じになる。
次のような場合の動作は不定。
- thread-idの値が不正である場合。
- スレッドが中断されたスレッドに対してCBL_THREAD_WAIT呼出しを行う場合。
関連項目