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

fts_ftp_open()−JP1/FTPデーモンとのコネクション確立−

形式

#include <apihead.h>
int fts_ftp_open(char *hostname)

機能

クライアント側のJP1/FTPデーモンとのコネクションを確立します。

引数

hostname

クライアント側のJP1/FTPデーモンが動作しているマシンのホスト名を指定します。NULLを指定した場合は，自ホスト名（OSのhostnameコマンドが返すホスト名：物理ホスト）が仮定されます。

FTPクライアントの自IPアドレス指定を有効にした場合，この引数での指定がFTPクライアントの自IPアドレスになります。NULLを指定した場合は，物理ホストのアドレスになります。

FTPクライアントの自IPアドレス指定を無効にした場合，FTPクライアントの自IPアドレスは，OSが自動的に割り当てるアドレスになります。FTPクライアントの自IPアドレス指定を有効にする方法については，「3.15 複数IPアドレス環境での使用」を参照してください。

注意事項

• この関数は，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デーモンとのコネクションが切断されました。伝送要求を再度登録したい場合は，ftp_ftp_open()から処理をし直す必要があります。	否
FTS_API_ERROR_MEMORY (805306122)	メモリを確保できません。	否
FTS_API_ERROR_UNDEFFTSSERV (805306123)	/etc/servicesファイルでJP1/FTPデーモンのClient (ftsc)の定義がされていません。	否
FTS_API_ERROR_MAXCONNECT (805306126)	同時に接続（fts_ftp_open()を発行）できるAPIの数（最大同時伝送数）を超えました。ほかのAPIが接続を切断（fts_ftp_close()を発行）するまで接続できません。最大同時伝送数については，「6. コマンド」の「ftsutil−環境情報の変更・表示−」を参照してください。	可

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

All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.