dc_dam_get

名称

物理ファイルからブロックの入力

形式

ANSI C ,C++の形式

#include <dcdami.h>
int  dc_dam_get(int fno,char *datadr,int datalen,DCLONG flags)

K&R版 C の形式

#include <dcdami.h>
int  dc_dam_get(fno,datadr,datalen,flags)
int      fno;
char     *datadr;
int      datalen;
DCLONG   flags;

機能

OpenTP1ファイルシステムの物理ファイルから,ブロック単位でデータを順に入力します。dc_dam_iopen関数を呼び出したあとで,dc_dam_get関数を使ってください。

ブロック長がバッファ長よりも小さい場合は,ブロックを入力してそのブロック長をリターン値として返します。ブロック長がバッファ長よりも大きい場合は,エラーリターンします。

物理ファイルからブロックを入力するときは,dc_dam_iopen関数で返されたリターン値のファイル記述子を設定します。

UAPで値を設定する引数

●fno

ブロックを入力するファイルの,ファイル記述子を設定します。

●datadr

入力バッファのアドレスを設定します。

●datalen

入力バッファの長さを設定します。設定できる範囲は504~2147483647です。

●flags

DCNOFLAGSを設定します。

リターン値

リターン値リターン値(数値)意味
正の整数正の整数は,入力ブロック長を示します。
DCDAMER_BADF-1603fnoに設定したファイル記述子は,正常にオープンして得られた記述子ではありません。
DAMファイルをオープンしていません。
DCDAMER_BUFER-1604ブロック長にバッファ長よりも大きい値を設定しています。
入力バッファ長に設定した値は,設定できる範囲を超えています。
DCDAMER_SEQER-1605DAMファイルにアクセスする関数を呼び出す順序が間違っています。
DCDAMER_PARAM_FLAGS-1611flagsに設定した値が間違っています。
DCDAMER_IOER-1620入力エラーが起こりました。
DCDAMER_ACCESS-1628アクセスしようとしたDAMファイルは,セキュリティ機能で保護されています。dc_dam_get関数を呼び出したUAPには,アクセス権限がありません。
DCDAMER_EOF-1637ファイルの終わりに達しました。
DCDAMER_NO_ACL-1646アクセスしようとしたDAMファイルは,セキュリティ機能で保護されています。該当するファイルに対するACLがありません。