fts_ftp_event_ex()−伝送終了結果の取得−
形式
#include <apihead.h> int fts_ftp_event_ex( int sock, FTS_FTP_API_RETDATA_EX *retdata )
機能
fts_ftp_asyn_request_ex()で登録した伝送の終了結果を取得します。
伝送の正常・異常は,伝送終了情報構造体のtrans_statusメンバで判断できます。
引数
sock
fts_ftp_open_ex()の戻り値を指定します。
retdata
伝送終了情報構造体のアドレスを指定します。伝送の終了結果を返します。
注意事項
-
この関数は,fts_ftp_open_ex()をコールしたあとで,コールしてください。
-
関数発行時に伝送が終了していない場合は,伝送が終了するまで待ちます。
戻り値
TRUE |
正常 |
FALSE |
異常 伝送終了情報の取得に失敗しました。 |
エラー情報を示す値はfts_errnoにセットされます。エラー情報の戻り値を次の表に示します。また,下記以外のエラーの場合には,システム関数のエラー番号がセットされていますので,システム関数のエラー番号を参照してください。
拡張エラー情報の戻り値 (10進数) |
説明 |
リトライの可否 |
---|---|---|
FTS_API_ERROR_DISCONNECT (805306116) |
JP1/FTPデーモンとのコネクションが切断されました。伝送要求を再度登録したい場合は,fts_ftp_close()を発行し,fts_ftp_open_ex()から処理をし直す必要があります。 |
否 |
FTS_API_ERROR_NODATA (805306120) |
登録されている伝送要求はありません。 |
否 |
FTS_API_ERROR_NOTSOCK (805306124) |
fts_ftp_open_ex()の戻り値を第1引数に指定していない場合があります。 |
否 |
FTS_API_ERROR_LOGIC (805306128) |
API内で論理矛盾エラーが発生しました。 |
否 |