fts_ftp_open_ex()−JP1/FTPとのコネクション確立−
形式
#include <winsock2.h> #include <apihead.h> SOCKET fts_ftp_open_ex( FTS_FTP_API_CONN_DATA *condata )
機能
JP1/FTP Clientサービスとのコネクションを確立します。
引数
condata
接続情報構造体のアドレスを指定します。接続情報に従ってJP1/FTP Clientサービスに接続します。
注意事項
-
この関数は,fts_ftp_syn_request_ex(),fts_ftp_asyn_request_ex(),fts_ftp_close()をコールする前にコールしてください。
-
この関数の戻り値は,ほかの関数を使用するときに必要です。
-
拡張エラー情報を取得する場合は,WSAGetLastError関数をコールする前にほかの関数をコールしないでください。情報がなくなる場合があります。
戻り値
ソケットハンドラ |
正常 |
INVALID_SOCKET |
異常 |
拡張エラー情報を取得するには,WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また,下記以外のエラーについては,MSDNのマニュアルを参照してください。
拡張エラー情報の戻り値 (16進数,10進数) |
説明 |
リトライの可否 |
---|---|---|
FTS_API_ERROR_NOTSTARTUP (0x2FFFFF00,805306112) |
WSAStartup()がコールされていません。 |
否 |
FTS_API_ERROR_UNDEFFTSHOST (0x2FFFFF01,805306113) |
指定したホスト名はHOSTSファイルで定義されていません。 |
否 |
FTS_API_ERROR_CONNREFUSED (0x2FFFFF02,805306114) |
接続要求が拒否されました。JP1/File Transmission Server/FTP Clientサービスが開始されていない場合があります。 |
否 |
FTS_API_ERROR_TIMEOUT (0x2FFFFF03,805306115) |
JP1/File Transmission Server/FTP Clientサービスへの接続要求がタイムアウトしました。JP1/File Transmission Server/FTP Clientサービスで接続処理に時間が掛かっているか,JP1/File Transmission Server/FTP Clientサービスが動作するマシンが停止している場合があります。 |
可 |
FTS_API_ERROR_UNREACH (0x2FFFFF04,805306116) |
JP1/File Transmission Server/FTP Clientサービスが動作するホストへルーティングされていない場合があります。 |
否 |
FTS_API_ERROR_DISCONNECT (0x2FFFFF05,805306117) |
JP1/File Transmission Server/FTP Clientサービスとのコネクションが切断されました。伝送要求を再度登録したい場合は,fts_ftp_open_ex()から処理をし直す必要があります。 |
否 |
FTS_API_ERROR_MEMORY (0x2FFFFF0B,805306123) |
メモリを確保できません。 |
否 |
FTS_API_ERROR_UNDEFFTSSERV (0x2FFFFF0C,805306124) |
SERVISESファイルでJP1/File Transmission Server/FTP Client (ftsc)の定義がされていません。 |
否 |
FTS_API_ERROR_MAXCONNECT (0x2FFFFF0F,805306127) |
同時に接続(fts_ftp_open_ex()を発行)できるAPIの数(64)を超えました。ほかのAPIが接続を切断(fts_ftp_close()を発行)するまで接続できません。 |
可 |