• FTPコマンド
• FTP応答コード
• ファイルダウンロード
• ファイルアップロード
• ファイル削除
• ファイル一覧取得

FTPコマンド

FTP応答コード

ファイルダウンロード

ファイルダウンロードは次の手順で行います。

1. InternetOpen() でWinInetを初期化、インターネットハンドルを取得する
2. InternetConnect() でFTP接続
3. FtpSetCurrentDirectory() でカレントディレクトリ移動
4. FtpGetFile() でファイルダウンロード
5. InternetCloseHandle() でインターネットハンドルを閉じる

WinInet初期化

WinInetを使うための前準備として「wininet.h」をインクルードし、「wininet.lib」をリンクしておきます。

WinInetライブラリの関数を使用する前にまず、InternetOpen() を使ってWinInet自体の初期化を行います。

HINTERNET InternetOpen(
	IN LPCTSTR lpszAgent,
	IN DWORD dwAccessType,
	IN LPCTSTR lpszProxyName,
	IN LPCTSTR lpszProxyBypass,
	IN DWORD dwFlags
);

FTP接続

InternetConnect() でFTPサーバに接続します。

HINTERNET InternetConnect(
	IN HINTERNET hInternet,
	IN LPCTSTR lpszServerName,
	IN INTERNET_PORT nServerPort,
	IN LPCTSTR lpszUsername,
	IN LPCTSTR lpszPassword,
	IN DWORD dwService,
	IN DWORD dwFlags,
	IN DWORD dwContext
);

カレントディレクトリ指定

FtpSetCurrentDirectory() でカレントディレクトリの指定を行います。

BOOL FtpSetCurrentDirectory(
	IN HINTERNET hFtpSession,
	IN LPCSTR lpszDirectory
);

ファイルのダウンロード

FtpGetFile() でファイルのダウンロードを行います。

BOOL FtpGetFile(
	IN HINTERNET hFtpSession,
	IN LPCSTR lpszRemoteFile,
	IN LPCSTR lpszNewFile,
	IN BOOL fFailIfExists,
	IN DWORD dwLocalFlagsAndAttributes,
	IN DWORD dwInternetFlags,
	IN DWORD dwContext
);

FTP切断

InternetCloseHandle() でインターネットから切断します。この関数は次のように定義されています。

BOOL InternetCloseHandle(
	IN HINTERNET hInet
);

FTP処理を行うにあたって「InternetOpen() でオープンしたWinInet用のインターネットハンドル」と「InternetConnect() でオープンしたFTP用のインターネットハンドル」の2つをオープンしていますので、両方ともクローズする必要があります。 FTP側をクローズしてからWinInet側をクローズします。

実装例

実装例を以下に示します。まず、接続処理です。

BOOL FtpConnect(
	LPCTSTR	serverName,	// [i]	サーバ名
	LPCTSTR	userName,	// [i]	ユーザー名
	LPCTSTR	password,	// [i]	パスワード
	LPCTSTR	baseDir )	// [i]　カレントディレクトリ
{
	BOOL		bRet = FALSE;
	HINTERNET	hInternet = NULL;
	HINTERNET	hFtp = NULL;



	//==== インターネットオープン ====//
	hInternet = InternetOpen(_T("Hoge"), INTERNET_OPEN_TYPE_DIRECT, NULL, NULL, 0);
	if(hInternet == NULL)
	{
		//-==- 失敗 -==-//
		return FALSE;
	}


	//==== FTP接続 ====//
	hFtp = InternetConnect(hInternet, serverName, INTERNET_INVALID_PORT_NUMBER, userName, password, INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE, 0);
	if(hFtp == NULL)
	{
		//-==- 失敗 -==-//
		return FALSE;
	}


	//==== カレントディレクトリ設定 ====//
	bRet = FtpSetCurrentDirectory(hFtp, baseDir);
	if(bRet == FALSE)
	{
		//-==- 失敗 -==-//
		return FALSE;
	}


	return TRUE;
}

次にダウンロード処理です。

BOOL FtpDownload(
	HINTERNET	hFtp,		// [i]	FTPハンドル
	LPCTSTR		remoteFile,	// [i]	ダウンロード対象ファイル名
	LPCTSTR		localFile )	// [i]	ダウンロードしたファイルの保存ファイル名
{
	BOOL	bRet = FALSE;



	bRet = FtpGetFile(hFtp, remoteFile, localFile, TRUE, FILE_ATTRIBUTE_NORMAL, FTP_TRANSFER_TYPE_BINARY, 0);
	if(bRet == FALSE)
	{
		//-==- 失敗 -==-//
	}


	return bRet;
}

ファイルアップロード

基本的な流れはファイルダウンロードと変わりません。ファイルダウンロードしていた部分を以下の処理に置き換えることでアップロード処理を実装することが出来ます。

ファイルのアップロード

FtpPutFile() でファイルのアップロードを行う。

BOOL FtpPutFile(
	IN HINTERNET hFtpSession,
	IN LPCSTR lpszLocalFile,
	IN LPCSTR lpszNewRemoteFile,
	IN DWORD dwFlags,
	IN DWORD dwContext
);

ディレクトリ作成

サーバに新規ディレクトリを作成するには FtpCreateDirectory() を使用する。

BOOL FtpCreateDirectory(
	IN HINTERNET hFtpSession,
	IN LPCSTR lpszDirectory
);

ファイル削除

サーバのファイル削除するには FtpDeleteFile() を使用します。

BOOL FtpDeleteFile(
	IN HINTERNET hFtpSession,
	IN LPCSTR lpszFileName
);

ファイル一覧取得

カレントディレクトリにあるファイル・ディレクトリを取得する方法を紹介します。

まず、カレントディレクトリを取得するために FtpGetCurrentDirectory() を使います。

BOOL FtpGetCurrentDirectory(
	IN HINTERNET hFtpSession,
	OUT LPSTR lpszCurrentDirectory,
	IN OUT LPDWORD lpdwCurrentDirectory
);

次にカレントディレクトリ内のディレクトリおよびファイルを検索します。検索には FtpFindFirstFile() および InternetFindNextFile() を使用します。

HINTERNET FtpFindFirstFile(
	IN HINTERNET hFtpSession,
	IN LPCSTR lpszSearchFile,
	OUT LPWIN32_FIND_DATA lpFindFileData,
	IN DWORD dwFlags,
	IN DWORD dwContext
);

BOOL InternetFindNextFile(
	IN HINTERNET hFind,
	OUT LPVOID lpvFindData
);