fts_ftp_open_ex()−JP1/FTPデーモンとのコネクション確立−
形式
#include <apihead.h> int fts_ftp_open_ex( FTS_FTP_API_CONN_DATA *condata )
機能
クライアント側のJP1/FTPデーモンとのコネクションを確立します。
引数
condata
接続情報構造体のアドレスを指定します。接続情報に従ってJP1/FTPデーモンに接続します。
注意事項
-
この関数は，fts_ftp_syn_request_ex()，fts_ftp_asyn_request_ex()，fts_ftp_close()をコールする前にコールしてください。
-
この関数の戻り値は，ほかの関数を使用するときに必要です。
戻り値
|
ソケットハンドラ |
正常 |
|
INVALID_SOCKET |
異常 |
エラーを示す値は，fts_errnoにセットされます。エラー情報の戻り値を次の表に示します。また，下記以外のエラーの場合には，システム関数のエラー番号がセットされていますので，システム関数のエラー番号を参照してください。
|
拡張エラー情報の戻り値 （10進数） |
説明 |
リトライの可否 |
|---|---|---|
|
FTS_API_ERROR_UNDEFFTSHOST (805306112) |
指定したホスト名は/etc/hostsファイルで定義されていません。 |
否 |
|
FTS_API_ERROR_CONNREFUSED (805306113) |
接続要求が拒否されました。JP1/FTPデーモンが開始されていない場合があります。 |
否 |
|
FTS_API_ERROR_TIMEOUT (805306114) |
JP1/FTPデーモンへの接続要求がタイムアウトしました。JP1/FTPデーモンで接続処理に時間が掛かっているか，JP1/FTPデーモンが動作するマシンが停止している場合があります。 |
可 |
|
FTS_API_ERROR_UNREACH (805306115) |
JP1/FTPデーモンが動作するマシンへルーティングされていない場合があります。 |
否 |
|
FTS_API_ERROR_DISCONNECT (805306116) |
JP1/FTPデーモンとのコネクションが切断されました。伝送要求を再度登録したい場合は，fts_ftp_open_ex()から処理をし直す必要があります。 |
否 |
|
FTS_API_ERROR_MEMORY (805306122) |
メモリを確保できません。 |
否 |
|
FTS_API_ERROR_UNDEFFTSSERV (805306123) |
/etc/servicesファイルでJP1/FTPデーモンのClient (ftsc)の定義がされていません。 |
否 |
|
FTS_API_ERROR_MAXCONNECT (805306126) |
同時に接続（fts_ftp_open_ex()を発行）できるAPIの数（最大同時伝送数）を超えました。ほかのAPIが接続を切断（fts_ftp_close()を発行）するまで接続できません。最大同時伝送数については，「6. コマンド」の「ftsutil−環境情報の変更・表示−」を参照してください。 |
可 |
|
FTS_API_ERROR_LOGIC (805306128) |
API内で論理矛盾エラーが発生しました。 |
否 |