形式
#include <apihead.h>
#include <winsock.h>
BOOL fts_ftp_event_ex( SOCKET sock, FTS_FTP_API_RETDATA_EX *retdata )
機能
fts_ftp_asyn_request_ex()で登録した伝送の終了結果を取得します。
伝送の正常・異常は,伝送終了情報構造体のtrans_statusメンバで判断できます。
引数
sock
fts_ftp_open()の戻り値を指定します。
retdata
伝送終了情報構造体のアドレスを指定します。伝送の終了結果を返します。
注意事項
戻り値
TRUE | 正常 |
FALSE | 異常 伝送終了情報の取得に失敗しました。 |
拡張エラー情報を取得するには,WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また,下記以外のエラーについては,winsockのマニュアルを参照してください。
拡張エラー情報の戻り値 (16進数,10進数) | 説明 | リトライの可否 |
---|---|---|
FTS_API_ERROR_NOTSTARTUP (0x2FFFFF00,8053306112) | WSAStartup()がコールされていません。 | 否 |
FTS_API_ERROR_DISCONNECT (0x2FFFFF05,8053306117) | JP1/File Transmission Server/FTP Clientサービスとのコネクションが切断されました。伝送要求を再度登録したい場合は,ftp_ftp_open()から処理をし直す必要があります。 | 否 |
FTS_API_ERROR_BADFORMAT (0x2FFFFF07,8053306119) | 引数に誤ったデータタイプのアドレスが指定されています。 | 否 |
FTS_API_ERROR_NODATA (0x2FFFFF09,8053306121) | 登録されている伝送要求はありません。 | 否 |
FTS_API_ERROR_NOTSOCK (0x2FFFFF0D,8053306125) | fts_ftp_open()の戻り値を第1引数に指定していない場合があります。 | 否 |
FTS_API_ERROR_LOGIC (0x2FFFFF10,8053306128) | API内で論理矛盾エラーが発生しました。 | 否 |