User manual - Cライブラリ解説書ver.1.01(2006年6月15日)
DT−300C ライブラリ解説書
199
機能 IOBOX からファイルを受信 関数名 HIO_ReceiveFile
IOBOX から指定したファイルを受信します。受信したファイルは指定したフォルダに保存されます。
送信元(IOBOX)のファイルは削除しません。関数を実行する前に HIO_GetFileInfo 関数を実行して、
ファイル情報を取得して下さい。
≪C言語インタフェース≫
【コーリングシーケンス】
ER ercd = HIO_ReceiveFile(IOFILEINFO *Iofileinfo, B *Folder, H Option, B disp);
【パラメータ】
struct _iofileinfo { /* IOBOX のファイル情報を格納する構造体です */
UH Index; データ受信の順番
UB Id[16]; 機器 ID
B FileName[8]; ファイル名
B FileExt[3]; ファイル拡張子
UW FileSize ファイルサイズ(単位は Byte)
UH FileDay; ファイルの日付
UH FileTime; ファイルの時刻
UB Attr; ファイル属性
} IOFILEINFO;
B *Folder :受信先のフォルダ名
フォルダ名はフルパスで'¥'まで指定します。
H Option :オプションフラグ(メモリ種類の指定)
IO_MEMORY_RAM :RAM から受信
IO_MEMORY_FROM :FROM から受信
B disp : 受信進捗バー切替
0 :非表示
1 :表示
【リターンパラメータ】
ER ercd :リターンコード
【リターンコード】
E_OK : ファイル受信成功
E_PRM : パラメータエラー
E_NG : 異常終了
≪備考≫
受信するフォルダに同一ファイル名のファイルがある場合は上書きを行います。
また、受信時は受信するファイルのファイルサイズ分の空き領域が必要になります。