現行のスレッドまたはプロセス用に指定されたモニターの読み込み機能を取得する。本ルーチンは、その機能が取得されるまでスレッドをブロックする。
call "CBL_MONITOR_READ" using by value monitor-handle
呼び出しプロトタイプ使用時 ( 説明の読み方) | PIC (32bitシステム) | |
---|---|---|
monitor-handle | cblt-pointer | usage pointer. |
monitor-handle | モニターハンドル |
return-code | 値0は呼出しが成功したことを意味し、それ以外の値はエラーを意味する。詳細は、 「同期ルーチンのRETURN-CODE値」を参照のこと。 |
スレッドが異常終了した場合、そのスレッドが取得したモニターはすべて解除される。スレッドがモニターを取得したまま正常終了した場合、そのモニターが解除されるか事項時システムエラーが発生する。これは、スレッドがCBL_THREAD_CREATEにより作成されたときのフラグ設定により異なる。
monitor-handleの値が不正である場合の動作は不定。