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()を発行）するまで接続できません。 |
可 |