C/C++ 实现FTP文件上传下载

举报
微软技术分享 发表于 2023/12/01 11:03:50 2023/12/01
【摘要】 FTP(文件传输协议)是一种用于在网络上传输文件的标准协议。它属于因特网标准化的协议族之一,为文件的上传、下载和文件管理提供了一种标准化的方法,在Windows系统中操作FTP上传下载可以使用WinINet库,WinINet(Windows Internet)库是 Windows 操作系统中的一个网络 API 库,用于访问 Internet 上的资源。它提供了一组函数,使开发人员能够创建网络...

FTP(文件传输协议)是一种用于在网络上传输文件的标准协议。它属于因特网标准化的协议族之一,为文件的上传、下载和文件管理提供了一种标准化的方法,在Windows系统中操作FTP上传下载可以使用WinINet库,WinINet(Windows Internet)库是 Windows 操作系统中的一个网络 API 库,用于访问 Internet 上的资源。它提供了一组函数,使开发人员能够创建网络应用程序,例如通过 HTTP 协议下载文件,发送 HTTP 请求,处理 cookie 等,本章将通过使用WinInet所提供的接口实现FTP文件上传下载功能,使得用户可以通过代码的方式上传或下载文件与FTP服务器交互。

首先读者需要自行搭建FTP服务器,这里可以使用20CN Mini Ftp这款迷你FTP服务器,配置好信息之后运行即可;

接着来介绍实现FTP通信的标准API函数信息,其核心的函数如下所示;

InternetOpen 函数,用于初始化 WinINet 库,返回一个句柄,该句柄可用于后续的网络操作。以下是该函数的原型和简要说明:

HINTERNET InternetOpen(
  LPCWSTR lpszAgent,  // 用户代理字符串,标识应用程序的名称
  DWORD   dwAccessType, // 访问类型,可以是 DIRECT、PRECONFIG 或 PROXY
  LPCWSTR lpszProxyName, // 代理服务器名称
  LPCWSTR lpszProxyBypass, // 代理服务器的绕过列表
  DWORD   dwFlags // 一些标志,例如INTERNET_FLAG_ASYNC(异步操作)
);
  • lpszAgent: 用户代理字符串,用于标识应用程序的名称。可以是应用程序的名称或标识符。
  • dwAccessType: 访问类型,指定应用程序的访问权限。可以是以下值之一:
    • INTERNET_OPEN_TYPE_DIRECT: 直接访问互联网。
    • INTERNET_OPEN_TYPE_PRECONFIG: 使用系统配置的代理。
    • INTERNET_OPEN_TYPE_PROXY: 使用指定的代理。
  • lpszProxyName: 代理服务器的名称,仅在 dwAccessTypeINTERNET_OPEN_TYPE_PROXY 时使用。
  • lpszProxyBypass: 代理服务器的绕过列表,仅在 dwAccessTypeINTERNET_OPEN_TYPE_PROXY 时使用。
  • dwFlags: 一些标志,用于指定其他选项,例如 INTERNET_FLAG_ASYNC 表示执行异步操作。

该函数返回一个 HINTERNET 句柄,用于后续的网络操作。如果操作失败,返回 NULL。在使用完 HINTERNET 句柄后,应该使用 InternetCloseHandle 函数关闭该句柄。

InternetConnect 函数,用于创建一个与指定服务器的连接。以下是该函数的原型和简要说明:

HINTERNET InternetConnect(
  HINTERNET     hInternet,       // InternetOpen 返回的句柄
  LPCWSTR       lpszServerName,  // 服务器的主机名
  INTERNET_PORT nServerPort,      // 服务器的端口号
  LPCWSTR       lpszUsername,    // 用户名
  LPCWSTR       lpszPassword,    // 密码
  DWORD         dwService,       // 服务类型,例如 INTERNET_SERVICE_HTTP
  DWORD         dwFlags,         // 一些标志,例如 INTERNET_FLAG_RELOAD
  DWORD_PTR     dwContext        // 应用程序定义的上下文
);
  • hInternet: 由 InternetOpen 返回的句柄,表示与 WinINet 库的连接。
  • lpszServerName: 服务器的主机名或 IP 地址。
  • nServerPort: 服务器的端口号。
  • lpszUsername: 连接需要的用户名。
  • lpszPassword: 连接需要的密码。
  • dwService: 服务类型,可以是以下值之一:
    • INTERNET_SERVICE_FTP: FTP 服务
    • INTERNET_SERVICE_HTTP: HTTP 服务
    • 其他服务类型,具体可查阅官方文档。
  • dwFlags: 一些标志,例如 INTERNET_FLAG_RELOAD 表示重新加载页面。
  • dwContext: 应用程序定义的上下文,可以是一个指针。

该函数返回一个 HINTERNET 句柄,用于后续的网络操作。如果操作失败,返回 NULL。在使用完 HINTERNET 句柄后,应该使用 InternetCloseHandle 函数关闭该句柄。

InternetWriteFile 函数,用于向已打开的互联网文件或句柄写入数据。以下是该函数的原型和简要说明:

BOOL InternetWriteFile(
  HINTERNET hFile,           // 由 InternetOpenUrl 或 HttpOpenRequest 返回的文件句柄
  LPCVOID   lpBuffer,        // 指向包含要写入的数据的缓冲区的指针
  DWORD     dwNumberOfBytesToWrite,  // 要写入的字节数
  LPDWORD   lpdwNumberOfBytesWritten  // 指向接收实际写入的字节数的指针
);
  • hFile: 由 InternetOpenUrlHttpOpenRequest 返回的文件句柄。
  • lpBuffer: 指向包含要写入的数据的缓冲区的指针。
  • dwNumberOfBytesToWrite: 要写入的字节数。
  • lpdwNumberOfBytesWritten: 指向接收实际写入的字节数的指针。

该函数返回一个布尔值,指示操作是否成功。如果成功,返回 TRUE,否则返回 FALSE

InternetReadFile 函数,用于从已打开的互联网文件或句柄读取数据。以下是该函数的原型和简要说明:

BOOL InternetReadFile(
  HINTERNET hFile,         // 由 InternetOpenUrl 或 HttpOpenRequest 返回的文件句柄
  LPVOID    lpBuffer,      // 指向接收数据的缓冲区的指针
  DWORD     dwNumberOfBytesToRead,  // 要读取的字节数
  LPDWORD   lpdwNumberOfBytesRead  // 指向接收实际读取的字节数的指针
);
  • hFile: 由 InternetOpenUrlHttpOpenRequest 返回的文件句柄。
  • lpBuffer: 指向接收数据的缓冲区的指针。
  • dwNumberOfBytesToRead: 要读取的字节数。
  • lpdwNumberOfBytesRead: 指向接收实际读取的字节数的指针。

该函数返回一个布尔值,指示操作是否成功。如果成功,返回 TRUE,否则返回 FALSE

FTP文件下载

如下代码是使用 WinInet 库实现的 FTP 文件下载功能。以下是对该代码的概述:

  1. 头文件引入和库链接
    • 代码使用了 <Windows.h><WinInet.h> 头文件,同时通过 #pragma comment(lib, "WinInet.lib") 链接了 WinInet 库,这是使用 WinInet 库的基本准备工作。
  2. FtpSaveToFile 函数
    • 该函数用于将数据保存到本地文件。它通过调用 CreateFile 创建一个空文件,然后使用 WriteFile 将数据写入文件,最后关闭文件句柄。这个函数在 FTP 文件下载后保存文件到本地。
  3. FTPDownload 函数
    • 这是主要的 FTP 下载函数。它使用 WinInet 提供的函数建立了一个 FTP 会话,连接到指定的 FTP 服务器,打开指定路径的文件,并通过循环调用 InternetReadFile 读取文件内容。
    • 下载的数据以字节数组的形式保存在 pDownloadData 中,下载完成后,调用 FtpSaveToFile 函数将数据保存到本地文件。
  4. 注意事项
    • 代码中使用了 RtlZeroMemory 函数清空内存,确保数据缓冲区的正确初始化。
    • 注意释放动态分配的内存,避免内存泄漏。
  5. 函数参数
    • 函数参数包括 FTP 服务器的主机名 (szHostName)、用户名 (szUserName)、密码 (szPassword)、FTP 路径 (szUrlPath),以及本地保存路径 (SavePath)。

总体而言,这段代码实现了基本的 FTP 文件下载功能,适用于从 FTP 服务器下载文件到本地。在使用时,确保提供正确的 FTP 服务器信息和路径,以及合适的本地保存路径。

#include <iostream>
#include <Windows.h>
#include <WinInet.h>

#pragma comment(lib, "WinInet.lib")

// 保存文件到本地
BOOL FtpSaveToFile(char *pszFileName, BYTE *pData, DWORD dwDataSize)
{
	// 创建空文件
	HANDLE hFile = CreateFile(pszFileName, GENERIC_READ | GENERIC_WRITE,
		FILE_SHARE_READ | FILE_SHARE_WRITE, NULL, CREATE_ALWAYS,
		FILE_ATTRIBUTE_ARCHIVE, NULL);
	if (INVALID_HANDLE_VALUE == hFile)
		return FALSE;

	DWORD dwRet = 0;

	// 写出数据到文件
	WriteFile(hFile, pData, dwDataSize, &dwRet, NULL);

	// 关闭句柄
	CloseHandle(hFile);
	return TRUE;
}

BOOL FTPDownload(char *szHostName, char *szUserName, char *szPassword, char *szUrlPath, char *SavePath)
{
	HINTERNET hInternet, hConnect, hFTPFile = NULL;
	BYTE *pDownloadData = NULL;
	DWORD dwDownloadDataSize = 0;
	DWORD dwBufferSize = 4096;
	BYTE *pBuf = NULL;
	DWORD dwBytesReturn = 0;
	DWORD dwOffset = 0;
	BOOL bRet = FALSE;

	// 建立会话并打开FTP操作
	hInternet = InternetOpen("WinInet Ftp", INTERNET_OPEN_TYPE_PRECONFIG, NULL, NULL, 0);
	hConnect = InternetConnect(hInternet, szHostName, INTERNET_INVALID_PORT_NUMBER,szUserName, szPassword, INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE, 0);
	hFTPFile = FtpOpenFile(hConnect, szUrlPath, GENERIC_READ, FTP_TRANSFER_TYPE_BINARY | INTERNET_FLAG_RELOAD, NULL);
	
	// 获取文件大小并初始化缓冲区
	dwDownloadDataSize = FtpGetFileSize(hFTPFile, NULL);
	pDownloadData = new BYTE[dwDownloadDataSize];
	RtlZeroMemory(pDownloadData, dwDownloadDataSize);
	pBuf = new BYTE[dwBufferSize];
	RtlZeroMemory(pBuf, dwBufferSize);
	
	// 循环接收数据
	do
	{
		// 读取数据
		bRet = InternetReadFile(hFTPFile, pBuf, dwBufferSize, &dwBytesReturn);
		if (FALSE == bRet)
			break;
		
		// 将读取到的数据追加到内存
		RtlCopyMemory((pDownloadData + dwOffset), pBuf, dwBytesReturn);
		dwOffset = dwOffset + dwBytesReturn;
	} while (dwDownloadDataSize > dwOffset);

	// 保存变量中的数据为文件
	FtpSaveToFile(SavePath, pDownloadData, dwDownloadDataSize);
	
	// 释放内存
	delete[]pDownloadData;
	pDownloadData = NULL;
	return TRUE;
}

调用FTPDownload时分别传入参数,参数1是IP地址,参数2是FTP登录用户名,参数3是FTP登录密码,参数4是服务器端根目录下的文件,参数5是下载文件到本地的路径,函数执行结束后返回一个BOOL状态值。

int main(int argc, char * argv[])
{
	BOOL bRET = FTPDownload("127.0.0.1", "admin", "admin", "/lyshark.jpg", "d://newtest/lyshark.jpg");
	if (bRET == TRUE)
	{
		printf("已下载文件 \n");
	}
	else
	{
		printf("下载失败 \n");
	}

	system("pause");
	return 0;
}

运行后则可以将服务器端上的/lyshark.jpg下载到本地的d://newtest/lyshark.jpg目录下,如下图所示;

FTP文件上传

如下代码使用 WinInet 库实现了 FTP 文件上传操作。以下是对该代码的概述:

  1. 函数功能
    • 该代码实现了 FTP 文件上传操作,将本地文件上传到指定的 FTP 服务器路径。
  2. 函数参数
    • 函数参数包括 FTP 服务器的主机名 (szHostName)、用户名 (szUserName)、密码 (szPassword)、FTP 路径 (szUrlPath),以及本地文件路径 (FilePath)。
  3. 建立会话和连接
    • 使用 InternetOpen 函数建立一个 WinInet 会话,然后使用 InternetConnect 函数建立到 FTP 服务器的连接。
  4. 打开 FTP 文件
    • 使用 FtpOpenFile 函数打开指定路径的 FTP 文件。如果文件不存在,将创建一个新文件。文件以二进制传输方式打开,并且具有重新加载标志。
  5. 打开本地文件
    • 使用 CreateFile 函数打开本地文件。如果本地文件不存在,将返回 INVALID_HANDLE_VALUE
  6. 获取文件大小和读取文件数据
    • 通过 GetFileSize 获取本地文件大小,然后根据文件大小动态分配内存,并使用 ReadFile 读取文件数据到内存中。
  7. 上传数据
    • 使用 InternetWriteFile 函数将内存中的文件数据上传到 FTP 服务器。上传成功后释放内存,上传失败则返回 FALSE。
  8. 注意事项
    • 确保提供正确的 FTP 服务器信息和路径,以及本地文件路径。
    • 释放动态分配的内存,避免内存泄漏。
    • 处理上传失败的情况,可能需要添加适当的错误处理代码。

总体而言,这段代码实现了基本的 FTP 文件上传功能,适用于将本地文件上传到 FTP 服务器。在使用时,注意提供正确的参数和处理可能出现的错误。

#include <iostream>
#include <Windows.h>
#include <WinInet.h>

#pragma comment(lib, "WinInet.lib")

// 实现文件上传操作
BOOL FTPUpload(char *szHostName, char *szUserName, char *szPassword, char *szUrlPath, char *FilePath)
{
  HINTERNET hInternet, hConnect, hFTPFile = NULL;
  DWORD dwBytesReturn = 0;
  DWORD UploadDataSize = 0;
  BYTE *pUploadData = NULL;
  DWORD dwRet, bRet = 0;

  // 建立会话并打开FTP操作
  hInternet = InternetOpen("WinInet Ftp", INTERNET_OPEN_TYPE_PRECONFIG, NULL, NULL, 0);
  hConnect = InternetConnect(hInternet, szHostName, INTERNET_INVALID_PORT_NUMBER, szUserName, szPassword, 
    INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE, 0);
  hFTPFile = FtpOpenFile(hConnect, szUrlPath, GENERIC_WRITE, FTP_TRANSFER_TYPE_BINARY | INTERNET_FLAG_RELOAD, NULL);

  // 打开文件
  HANDLE hFile = CreateFile(FilePath, GENERIC_READ | GENERIC_WRITE,FILE_SHARE_READ | 
    FILE_SHARE_WRITE, NULL, OPEN_EXISTING,FILE_ATTRIBUTE_ARCHIVE, NULL);
  if (INVALID_HANDLE_VALUE == hFile)
    return FALSE;

  // 获取文件大小
  UploadDataSize = GetFileSize(hFile, NULL);
  pUploadData = new BYTE[UploadDataSize];
  // 读取文件到缓冲区
  ReadFile(hFile, pUploadData, UploadDataSize, &dwRet, NULL);
  UploadDataSize = dwRet;

  // 开始上传数据
  bRet = InternetWriteFile(hFTPFile, pUploadData, UploadDataSize, &dwBytesReturn);
  if (FALSE == bRet)
  {
    delete[]pUploadData;
    return FALSE;
  }
  delete[]pUploadData;
  return TRUE;
}

文件上传与下载一样,FTPUpload通过传入服务器地址,用户名,密码,上传后的文件名,被上传本地文件路径;

int main(int argc, char * argv[])
{
	BOOL bRET = FTPUpload("127.0.0.1", "admin", "admin", "/abc.exe", "c://nc.exe");
	if (bRET == TRUE)
	{
		printf("已上传文件 \n");
	}
	else
	{
		printf("上传失败 \n");
	}

	system("pause");
	return 0;
}

上传成功后输出如下图所示;

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。