fts_ftp_asyn_request_ex()伝送要求の登録(非同期)

形式

#include <apihead.h>

int  fts_ftp_asyn_request_ex( int sock,
                    char *cardname,
                    FTS_FTP_API_DATA_EX *data,
                    unsigned long *trno,
                    int get_return_flag )

機能

JP1/FTPに伝送要求を登録し,伝送の終了を待ちません。終了結果は,fts_ftp_event_ex()で取得します。伝送要求の内容は,伝送情報構造体で指定するか,登録済みの伝送カード名を指定することで定義できます。伝送の正常・異常は,fts_ftp_event_ex()で取得した,伝送終了情報構造体のtrans_statusメンバで判断できます。

引数

sock

fts_ftp_open()の戻り値を指定します。

cardname

登録済カード名称を指定します。この内容に従ってファイル伝送要求を登録します。

data

伝送情報構造体のアドレスを指定します。

cardnameにNULLが指定された場合は,この内容に従ってファイル伝送要求を登録します。

cardnameに登録済みの伝送カード名が指定された場合は,伝送カードの内容を登録します。伝送情報構造体には,登録した伝送情報が格納されます。この伝送情報構造体は,別にファイル伝送要求を登録する際に再度利用できます。

trno

伝送番号を格納するアドレスを指定します。

履歴情報やfts_ftp_event_ex()で取得した伝送終了情報内の伝送番号と一致します。

get_return_flag

FTS_GET_RETURNを指定した場合は,fts_ftp_event_ex()をコールすることで伝送終了情報を取得できます。

FTS_UNGET_RETURNを指定した場合は,取得できません。

注意事項

戻り値

TRUE正常
FALSE異常
伝送要求の登録に失敗しました。

エラーを示す値はfts_errnoにセットされます。エラー情報の戻り値を次の表に示します。また,下記以外のエラーの場合には,システム関数のエラー番号がセットされていますので,システム関数のエラー番号を参照してください。

拡張エラー情報の戻り値
(10進数)
説明リトライの可否
FTS_API_ERROR_DISCONNECT
(805306116)
JP1/FTPデーモンとのコネクションが切断されました。伝送要求を再度登録したい場合は,ftp_ftp_open()から処理をし直す必要があります。
FTS_API_ERROR_NOTREADCARD
(805306117)
指定したカード名称が参照できません。
カードが正しく登録されていない場合があります。
FTS_API_ERROR_MAXPALTRANS
(805306119)
同時に伝送できる最大数(最大同時伝送数)を超えています。ほかの伝送が終了したあと,再度伝送要求を登録してください。最大同時伝送数については,「6. コマンド」の「ftsutil-環境情報の変更・表示-」を参照してください。
FTS_API_ERROR_MEMORY
(805306122)
メモリを確保できません。
FTS_API_ERROR_NOTSOCK
(805306124)
fts_ftp_open()の戻り値を第1引数に指定していない場合があります。
FTS_API_ERROR_FTSMISS
(805306125)
JP1/FTPデーモンで何かの異常が発生しました。
FTS_API_ERROR_FORCEEND
(805306127)
JP1/FTPデーモンが強制終了しました。
FTS_API_ERROR_LOGIC
(805306128)
API内で論理矛盾エラーが発生しました。
FTS_API_ERROR_MAXGROUPS
(805306129)
セカンダリグループの最大数を超えています。