JP1/File Transmission Server/FTP（Windows(R)用）

fts_ftp_event_ex()−伝送終了結果の取得−

形式

#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

伝送終了情報構造体のアドレスを指定します。伝送の終了結果を返します。

注意事項

• この関数は，fts_ftp_open()をコールしたあとでコールしてください。
• 関数発行時に伝送が終了していない場合は，伝送が終了するまで待ちます。
• 拡張エラー情報を取得する場合は，WSAGetLastError関数をコールする前にほかの関数をコールしないでください。情報がなくなる場合があります。

戻り値

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内で論理矛盾エラーが発生しました。	否

[目次][前へ][次へ]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.