ヒープからバイト単位でデータを読み取ります。
構文:
call "CBL_READ_VFILE" using by value heap-id
heap-ref
heap-length
by reference heap-buffer
returning status-code
パラメーター:
|
呼び出しプロトタイプ使用時 (「説明の読み方」を参照)
|
PIC |
heap-id |
cblt-vfile-handle |
pic x(2) comp-5 |
heap-ref |
cblt-x4-comp5 |
pic x(4) comp-5 |
heap-length |
cblt-x4-comp5 |
pic x(4) comp-5 |
heap-buffer |
pic x(n)
|
pic x(n)
|
status-code |
「説明の読み方」を参照。
|
|
入力パラメーター:
heap-id |
ヒープを開いた際に割り当てられたヒープ ハンドルが格納されます。 |
heap-ref |
読み取りを開始するヒープのオフセット。.NET では、この最大値は 0x7fffffff に制限されています。 |
heap-length |
読み取るバイト数。 |
出力パラメーター:
heap-buffer |
読み取ったデータを格納するバッファー。このバッファーのサイズはプログラム側で決定します。データを確実に格納できる容量を確保してください。 |
説明:
データが書き込まれていないヒープ領域の読み取りを試みると、バッファーには不明なデータが返されます。