CBL_THREAD_KILL

指定されたスレッドを強制終了、つまり異常終了させて関連するすべてのリソースをデタッチします。

構文:

call "CBL_THREAD_KILL" using by value thread-id

パラメーター:

  呼び出しプロトタイプ使用時 (「説明の読み方」を参照) PIC
thread-id cblt-pointer USAGE POINTER

入力パラメーター:

thread-id スレッド識別子へのポインター。

出力パラメーター:

return-code 成否を示す値。「スレッド制御ルーチンの RETURN-CODE 値」を参照してください。

説明:

このルーチンを使用して強制終了できるのは、CBL_THREAD_CREATE によって作成されたスレッドのみで、他の方法によって作成されたスレッドには使用できません。

対象のスレッドが、すでに完了しているがデタッチされていない場合は、単にそのスレッドがデタッチされ、戻り値が破棄されます。

この呼び出しは、thread-id を現在のスレッドに設定して使用することもできます。その場合、戻り値が NULL の CBL_THREAD_EXIT と同じことになります。

次の場合、動作は不定になります。

  • thread-id の値が無効である場合
  • 強制終了するスレッドに対する CBL_THREAD_WAIT の呼び出しがあるスレッドが存在する場合