WinInet库之FTP通信

矫情吗；* 2022-09-15 05:52 285阅读 0赞

// 文件传输协议(File Transfer Protocol,简称FTP)用在互联网上文件的双向传输，是主用于文件的上传和下载处理的协议。
    // 上传是指将文件从本地计算机中复制到远程主机上。下载是指将远程主机上的文件复制到本地计算机上。
    // FTP是专门为文件传输而生的，传输效率高，稳定性好。公司内部通常会有多个FTP服务器，用于共享公司内部的资料。
    
    // 在Windows上，微软提供了WinInet(即Windows Internet)库用于方便网络程序的开发。WinInet支持FTP、HTTP(s)、Gopher类型的网络开发。
    // 也就是有专门的WIN32 API函数。
    
    // PS：InternetOpen函数：
    // 功能：初始化一个应用程序，以使用WinInet函数。
    // 原型：HINTERNET InternetOpen(
    // _In_ LPCTSTR lpszAgent,
    // _In_ DWORD dwAccessType,
    // _In_ LPCTSTR lpszProxyName,
    // _In_ LPCTSTR lpszProxyBypass,
    // _In_ DWORD dwFlags
    // )
    // 参数：lpszAgent：指定调用WinInet函数的应用程序或实体的名称，也就是给定一个字符串，用于标识这个程序。
    // dwAccessType：访问类型，参数可以是以下值之一：
    // INTERNET_OPEN_TYPE_DIRECT：直接连接网络(不使用代理)
    // INTERNET_OPEN_TYPE_PRECONFIG：获取代理或者直接从注册表中获取的配置，使用代理连接网络
    // INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY：获取代理或者直接从注册表中获取的配置，并防止启用Microsoft JScript或互联网设置(INS)文件的使用
    // INTERNET_OPEN_TYPE_PROXY：通过代理来请求，除非代理旁路列表中提供的名称解析绕过代理。在这种情况下，使用该功能。
    // lpszProxyName：指定代理服务器的名称，如果dwAccessType为INTERNET_OPEN_TYPE_PROXY，则此参数应当设置为NULL
    // lpszProxyBypass：指定可选列表的主机名或IP地址。如果dwAccessType设置为INTERNET_OPEN_TYPE_PROXY，则此参数省略为NULL
    // dwFlags：可以是以下值的组合：
    // INTERNET_FLAG_ASYNC：异步请求
    // INTERNET_FLAG_FROM_CACHE：不进行网络请求，从缓存中返回所有实体。
    // INTERNET_FLAG_OFFLINE：与INTERNET_FLAG_CACHE相同，不发出网络请求，所有实体都从缓存中返回。
    // 结果：成功，返回一个有效的句柄，失败，返回NULL。
    
    // PS：InternetConnect函数
    // 功能：建立互联网的连接。
    // 原型：HINTERNET WINAPI InternetConnect(
    // HINTERNET hInternet,
    // LPCTSTR lpszServerName,
    // INTERNET_PORT nServerPort,
    // LPCTSTR lpszUserName,
    // lPCTSTR lpszPassword,
    // DWORD dwService,
    // DWORD dwFlags,
    // DWORD dwContext
    // )
    // 参数：hInternet：由InternetOpen函数返回的句柄。
    // lpszServerName：连接的IP或主机名。
    // nServerPort：连接的端口。
    // lpszUserName：用户名，没有则设置NULL。
    // lpszPassword：密码，没有则设置为NULL。
    // dwService：使用的服务器类型，可以使用以下值之一：
    // INTERNET_SERVICE_FTP = 1：连接到一个FTP服务器上。
    // INTERNET_SERVICE_GOPHER = 2：连接到一个Gopher服务器上。
    // INTERNET_SERVICE_HTTP = 3：连接到一个HTTP服务器上。
    // dwFlags：文件传输形式及缓存标记，一般置零。
    // dwContext：置为零。
    // 结果：成功返回非零，失败返回零。
    
    // PS：FtpOpenFile函数：
    // 功能：访问FTP服务器上的远程文件以执行读取或写入操作。
    // 原型：HINTERNET FtpOpenFile(
    // _In_ HINTERNET hConnect,
    // _In_ LPCTSTR lpszFileName,
    // _In_ DWORD dwAccess,
    // _In_ DWORD dwFlags,
    // _In_ DWORD_PTR dwContext
    // )
    // 参数：hConnect：由InternetConnect返回的句柄。
    // lpszFileName：要访问的文件名。通常是URL+文件后缀
    // dwAcess：可以是GENERIC_READ或者GENERIC_WRITE，但不能同时拥有。
    // dwFlags：传输类型，可以是以下值之一：
    // FTP_TRANSFER_TYPE_ASCII：使用FTP的ASCII传输方法。
    // FTP_TRANSFER_TYPE_BINARY：使用FTP的图像传输方法传输文件，也就是二进制方式。
    // FTP_TRANSFER_TYPE_UNKNOWN：默认使用FTP_TRANSFER_TYPE_BINARY。
    // INTERNET_FLAG_TRANSFER_ASCII：以ASCII格式传输文件。
    // INTERNET_FLAG_TRANSFER_BINARY：将文件作为二进制文件进行传输。
    // 控制文件的缓存，使用以下值之一：
    // INTERNET_FLAG_HYPERLINK：强制重新加载。
    // INTERNET_FLAG_NEED_FILE：如果无法缓存文件，则会创建临时文件。
    // INTERNET_FLAG_RELOAD：强制从源服务器下载所请求的文件、对象或目录列表，而不是从缓存中下载。
    // INTERNET_FLAG_RESYNCHRONIZE：如果资源资上次现在依赖已被修改，则请重新加载HTTP资源。
    // dwContext：置零。
    // 结果：成功返回一个句柄，失败返回NULL。
    
    // PS：InternetWriteFile函数：
    // 功能：将数据写入打开的互联网文件。
    // 原型：BOOL InterneetWriteFile(
    // _In_ HINTERNET hFile,
    // _In_ LPVOID lpBuffer,
    // _In_ DWORD dwNumberOfBytesToWrite,
    // _Out_ LPDWORD lpdwNumberOfBytesWrite
    // )
    // 参数：hFile：由FtpOpenFile函数返回的互联网文件句柄。
    // lpBuffer：缓存区，要上传文件的数据。
    // dwNumberOfBytesToWrite：缓存区大小。
    // lpdwNumberOfBytesWrite：接收写入的字节量。
    // 结果：成功，返回TRUE，失败，返回FALSE。
    
    // PS：InternetReadFile函数：
    // 功能：从打开互联网文件中读取数据。
    // 原型：BOOL InternetReadFile(
    // _In_ HINTERNET hFile,
    // _Out_ LPVOID lpBuffer,
    // _In_ DWORD dwNumberOfBytesToRead,
    // _Out_ LPDWORD lpdwNumberOfBytesRead
    // )
    // 参数：hFile：由FtpOpenFile函数打开的互联网文件的句柄。
    // lpBuffer：接收数据的缓存区。
    // dwNumberOfBytesToRead：预读取数据的字节量。
    // lpdwNumberOfBytesRead：读取字节量的变量。
    // 结果：成功，返回TRUE，失败返回FALSE。
    
    // FTP的URL格式：FTP://账号:密码@主机/子目录或文件。示例：ftp://admin:123456@192.168.0.1/mycode/520.zip。
    
    // PS：基于WinInet库的FTP文件上传的流程如下：
    // 1.首先，调用InternetCrackUrl函数对URL进行分解，从URL中获取后续操作需要的信息。比如用户名、密码、host等。
    // 2.调用InternetOpen初始化WinInet库，建立网络会话，获取会话句柄。
    // 3.调用INternetConnect与服务器建立连接，并设置FTP数据传输方式。
    // 4.调用FtpOpenFile函数，根据文件路径，以GENERIC_WRITE的方式创建文件，并获取服务器上的文件句柄。
    // 5.调用InternetWriteFile函数把本地数据写入到互联网文件中，实现文件上传功能。
    // 6.关闭打开的句柄，释放缓存区资源。
    
    
    // PS：示例代码：
    
    // FTP文件上传
    
    BOOL Ftp_Upload(char* pszUploadUrl, BYTE* pUploadData, DWORD dwUploadDataSize)
    { 
        // 变量(略)
    
        // 分解URL
        if (FALSE == Ftp_UrlCrack(pszUploadUrl, szScheme, szHostName, szUserName, szPassword, szUrlPath, szExtraInfo, MAX_PATH))
        { 
            return FALSE;
        }
    
        // 拼接文件路径
        if (0 < ::lstrlen(szExtraInfo))
        { 
            ::lstrcat(szUrlPath, szExtraInfo);
        }
    
        do 
        { 
            // 建立会话
            hInternet = ::InternetOpen("FTP upload v1.0", INTERNET_OPEN_TYPE_PRECONFIG, NULL, NULL, 0);
            if (NULL == hInternet)
            { 
                Ftp_ShowError("InternetOpen");
                break;
            }
    
            // 建立会话
            hConnect = ::InternetConnect(hInternet, szHostName, szUserName, szPassword, INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE, 0);
            if (NULL == hConnect)
            { 
                ::InternetCloseHandle(hInternet);
                Ftp_ShowError("InternetConnect");
                break;
            }
    
            // 打开FTP文件，与本地文件操作类似
            hFile = ::FtpOpenFile(hConnect, szUrlPath, GENERIC_WRITE, FTP_TRANSFER_TYPE_BINARY | INTERNET_FLAG_RELOAD, NULL);
            if (NULL == hFile)
            { 
                ::InternetCloseHandle(hInternet);
                ::InternetCloseHandle(hConnect);
                Ftp_ShowError("FtpOpenFile");
                break;
            }
    
            // 上传数据
            bRet = ::InternetWriteFile(hFile, pUploadData, dwUploadDataSize, &dwBytesReturn);
            if (FALSE == bRet)
            { 
                ::InternetCloseHandle(hInternet);
                ::InternetCloseHandle(hConnect);
                ::InternetCloseHandle(hFile);
                Ftp_ShowError("InternetWriteFile");
                break;
            }
        } while (FALSE);
    
        // 释放内存并关闭句柄(略)
    
        return bRet;
    }
    
    // PS：基于WinInet的FTP文件下载步骤如下：
    // 1.使用InternetCrackUrl分解URL，获取用于后续操作需要的信息。
    // 2.调用InternetOpen函数初始化WinInet库，建立会话，获取会话句柄。
    // 3.调用InternetOpen函数与FTP服务器建立连接，获取连接句柄。
    // 4.调用FtpOpenFile函数，打开互联网文件，获取其句柄。
    // 5.调用FtpGetFileSize函数获取文件大小，并根据文件大小申请缓存区，用于存储文件数据。
    // 6.调用InternetReadFile函数，读取互联网文件数据到缓存区中，采用循环读取的方式。
    // 7.关闭打开的句柄，进行清理工作。
    
    // PS：示例代码：
    
    // FTP文件下载
    
    BOOL Ftp_Download(char* pszDownloadUrl, BYTE** ppDownloadData, DWORD* pdwDownloadDataSize)
    { 
        // 变量(略)
    
        // 分解URL
        if (FALSE == Ftp_UrlCrack(pszDownloadUrl, szScheme, szHostName, szUserName, szPassword, szUrlPath, szExtraInfo, MAX_PATH))
        { 
            return FALSE;
        }
    
        // 拼接文件路径
        if (0 < ::lstrlen(szExtraInfo))
        { 
            ::lstrcat(szUrlPath, szExtraInfo);
        }
    
        do
        { 
            // 建立会话
            hInternet = ::InternetOpen("Ftp Download v1.0", INTERNET_OPEN_TYPE_PRECONFIG, NULL, NULL, 0);
            if (NULL == hInternet)
            { 
                Ftp_ShowError("InternetOpen");
                break
            }
    
            // 建立连接
            hConnect = ::InternetConnect(hInternet, szHostName, INTERNET_INVALID_PORT_NUMBER, szUserName, szPassword, INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE, 0);
            if (NULL == hConnect)
            { 
                ::InternetCloseHandle(hInternet);
                Ftp_ShowError("InternetConnect");
                break;
            }
    
            // 打开FTP文件
            hFile = ::FtpOpenFile(hConnect, szUrlPath, GENERIC_READ, FTP_TRANSFER_TYPE_BINARY | INTERNET_FLAG_RELOAD, NULL);
            if (NULL == hFile)
            { 
                ::InternetCloseHandle(hInternet);
                ::InternetCloseHandle(hConnect);
                Ftp_ShowError("FtpOpenFile");
                break;
            }
    
            // 获取文件大小
            dwDownloadDataSize = ::FtpGetFileSize(hFile, NULL);
    
            // 申请动态空间
            pDownloadData = new BYTE[dwDownloadDataSize];
            if (NULL == pDownloadData)
            { 
                break;
            }
            ::RtlZeroMemory(pDownloadData, dwDownloadDataSize);
    
            // 申请一个小空间，用于循环接收数据
            pBuf = new BYTE[dwBufSize];
            if (NULL == pBuf)
            { 
                break;;
            }
    
            // 循环接收数据
            do
            { 
                ::RtlZeroMemory(pBuf, dwBufSize);
                // 接收数据
                bRet = ::InternetReadFile(hFile, pBuf, dwBufSize, &dwBytesReturn);
                if (FALSE == bRet)
                { 
                    Ftp_ShowError("InternetReadFile");
                    break;
                }
                // 拷贝数据
                ::RtlCopyMemory((PVOID)(pDownloadData + dwOffset), pBuf, dwBytesReturn);
    
                // 更新数据
                dwOffset += dwBytesReturn;
            } while (dwOffset < dwDownloadDataSize);
        } while (FALSE);
    
        // 返回数据
        **pDownloadData = pDownloadData;
        *pdwDownloadDataSize = dwDownloadDataSize;
    
        // 关闭句柄，释放内存(略)
    
        return bRet;
    }