物理ファイルへブロックの出力

ANSI C ，C++の形式

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

K&R版 C の形式

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

OpenTP1ファイルシステム上に作成した物理ファイルにブロック単位でデータを順に出力します。データ長がブロック長よりも小さい場合は，データの後ろをヌル文字で埋めます。大きい場合は，エラーリターンします。

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

●fno

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

●datadr

出力するデータのアドレスを設定します。

●datalen

出力するデータの長さを設定します。設定できる範囲は504〜2147483647です。

●flags

DCNOFLAGSを設定します。

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