CBL_THREAD_KILL
指定されたスレッドを中断し、スレッドを異常終了させて関連するリソースをすべて解放する。
構文:
call "CBL_THREAD_KILL" using by value thread-id
パラメーター：
| 呼び出しプロトタイプ使用時 ( 説明の読み方) | PIC (32 ビット システム) | |
|---|---|---|
| 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呼び出しを行う場合。
関連項目