CFTPTransferDlg & CFTPTransferer v1.24

Welcome to CFTPTransferDlg, an MFC dialog which performs FTP uploads and downloads similar to the old Internet Explorer download dialog as shown below:

Alternatively if you do not want to use any UI, you can use the CFTPTransferer class (which CFTPTransferDlg uses internally).

Copyright

• You are allowed to include the source code in any product (commercial, shareware, freeware or otherwise) when your product is released in binary form.
• You are allowed to modify the source code in any way you want except you cannot modify the copyright details at the top of each module.
• If you want to distribute source code with your application, then you are only allowed to distribute versions released by the author. This is to maintain a single distribution point for the source code.

Features

• Uses Wininet to perform the transfer, hence there is no additional runtime requirements.
• Is fully Unicode enabled.
• Supports non-UI and UI based methods of FTP transfers.
• Supports bandwidth throttling.

History

v1.24 (17 April 2022)

• Updated copyright details.
• Updated the code to use C++ uniform initialization for all variable declarations.

v1.23 (12 December 2021)

• Updated copyright details.
• Fixed more Clang-Tidy static code analysis warnings in the code.

v1.22 (4 April 2020)

• Updated copyright details.
• Fixed more Clang-Tidy static code analysis warnings in the code.

v1.21 (27 December 2019)

• Fixed various Clang-Tidy static code analysis warnings in the code.

v1.20 (29 September 2019)

• Fixed a number of compiler warnings when the code is compiled with VS 2019 Preview

v1.19 (6 May 2019)

• Updated copyright details.
• Updated the code to clean compile on VC 2019

v1.18 (6 December 2018)

• Updated copyright details.
• Fixed a number of C++ core guidelines compiler warnings. These changes mean that the code will now only compile on VC 2017 or later.
• Changed enums to enum class throughout codebase
• Reworked the CFTPTransferer class to be independent of MFC
• Reworked all the notifications from the worker thread in CFTPTransferDlg to the UI to use PostMessage

v1.17 (23 December 2017)

• Fix compile problems in CFTPTransferer::CreateSession in VC2017
• Updated the code to compile cleanly when _ATL_NO_AUTOMATIC_NAMESPACE is defined.

v1.16 (5 October 2017)

• Replaced CString::operator LPC*STR() calls throughout the codebase with CString::GetString calls.

v1.15 (24 January 2017)

• Updated copyright details
• Updated the code to clean compile on VC 2010 to 2015
• Replaced BOOL with bool throughout the codebase
• Updated the code to clean compile using /analyze
• Replaced NULL with nullptr throughout the codebase. This means that the code now requires VC 2010 at a minimum to compile.
• Implemented support for send and receive timeouts

v1.14 (18 May 2008)

• Updated copyright details
• Addition of AttachSession and DetachSession methods which allow the lifetime of the session to be controlled independently of the lifetime of the CFTPTransferer instance. Thanks to Hans Dietrich for prompting this update
• Updated the logic in CFTPTransferDlg::OnWininetStatusCallBack to correctly handle ASCII or Unicode strings. Thanks to Hans Dietrich for prompting this update.
• Fixed a spelling mistake in the IDS_FTPTRANSFER_RETRIEVING_FILE string resource.

v1.13 (30 December 2007)

• Updated the code to remove VC 6 style appwizard comments.
• Updated the sample apps to clean compile on VC 2008.
• CFTPTransferer::GetErrorMessage now uses the FORMAT_MESSAGE_IGNORE_INSERTS flag. For more information please see Raymond Chen's blog at http://blogs.msdn.com/oldnewthing/archive/2007/11/28/6564257.aspx. Thanks to Alexey Kuznetsov for reporting this issue.
• CFTPTransferer::GetErrorMessage now uses Checked::tcsncpy_s if compiled using VC 2005 or later.

v1.12 (10 June 2007)

• Minor bug fix to CFTPTransferDlg::SetTimeLeft to correctly handle 64 bit integer parameter.

3 June 2007

• Updated documentation to refer to need for Platform SDK if you are compiling the code with an old compiler such as Visual C++ 6.

v1.11 (18 May 2007)

• Updated documentation to say that resume is not supported.
• Updated documentation to better describe how to add the classes into your application. Thanks to Roger Huggins for prompting this update.

v1.10 (14 April 2007)

• Updated copyright details.
• Following feedback from Philippe MARINUTTI, it looks like you just cannot do FTP resumes using Wininet. For more information on the issues involved, please see http://groups.google.com/group/microsoft.public.inetsdk.programming.wininet/browse_thread/thread/b43094df4de38a35/376b4c14acdb9be6?lnk=st&q=FtpCommand+REST&rnum=9&hl=en#376b4c14acdb9be6, http://groups.google.com/group/microsoft.public.inetsdk.programming.wininet/browse_thread/thread/229a31ebda334098/4facc1ebcc9a7c2e?lnk=st&q=FtpCommand+REST&rnum=6&hl=en#4facc1ebcc9a7c2e, http://groups.google.com/group/microsoft.public.inetsdk.programming.wininet/browse_thread/thread/5f1a1d5c92e6548d/1dfcc8fb46c6c721?lnk=st&q=FtpCommand+REST&rnum=10&hl=en#1dfcc8fb46c6c721 & http://groups.google.com/group/microsoft.public.inetsdk.programming.wininet/browse_thread/thread/31a840505f3b45bc/8c1732d682ba4f7b?lnk=st&q=FtpCommand+REST&rnum=1&hl=en#8c1732d682ba4f7b. As such I have removed support for resumes (CFTPTransferer::m_dwStartPos) from the code. If you would like to support FTP resumes, then you will need to look to commercial alternatives such as SmartFTP, Xceed FTP Library, or FTP Client Engine for C/C++.

v1.09 (23 November 2006)

• Updated the code to clean compile on VC 2005
• Updated copyright details
• Updated the code to compile correctly for Win64
• Integrated the _FTP_DOWNLOAD_DATA class into the CFTPTransferDlg class
• Optimized member variable construction in CFTPTransferDlg constructor
• Code now uses newer C++ style casts in preference to C style casts
• Refactored the code to produce a new CFTPTransferer class which provides a synchronous interface to Wininet FTP which CFTPTransferDlg now inherits from. This is in line with the most recent updates in the author's CHttpDownloadDlg class
• Class now handles extra large files (> 4GB)
• Code now correctly handles ERROR_INTERNET_EXTENDED_ERROR errors
• Updated documentation to use same style as the web site.

v1.08 (13 June 2003)

• Now supports connection timeouts since Wininet doesn't <ggg>.
• Other various tidy ups to the code, such as review of all the TRACE statements and calls to GetLastError

v1.07 (30 October 2002)

• Fixed a problem with seeking to the correct position when resuming a download. Thanks to Liping Dai for this bug report.

5 June 2002

• Renamed some string resources used by the class to maintain naming consistency.

v1.06 (20 April 2002)

• Modified the code to correctly support FTP resumes. Feedback from jony for reporting this issue.
• Fixed a bug in the call to AfxBeginThread.

v1.05 (2 February 2002)

• Now includes support for FTP resumes via the FTP command "REST". Please note that IE 5.01 SP2 is required to support this. This support is experimental, so your feedback is welcome.
• Updated documentation to include explicit requirements for the class.

v1.04 (17 October 2001)

• Now includes support for PASV
• Fixed a Unicode issue in CFTPTransferDlg::OnStatusCallBack
• Support for preconfigured or direct settings.
• Support for proxies

v1.03 (10 October 2001)

• Fixed a problem where old style MFC exception handling was being used instead of C++ standard.

v1.02 (11 June 2001)

• Updated copyright details.
• Now provides Bandwidth throttling support. Thanks to Karim Mribti for this good addition.
• Minor code tidy up thanks to Bounds Checker
• m_bPromptForOverwrite now works correctly for downloads as well as uploads
• Fixed a problem with the progress control not updating correctly

10 December 2000

• Updated distribution to describe when you need to "#include" and link to.

v1.01 (31 October 2000)

• Added a m_bPromptOverwrite variable
• Fixed a bug in the way the progress control was being updated.

v1.0 (4 January 2000)

• Initial Public Release

Usage

• To use CFTPTransferDlg in your project simply include FTPTransferDlg.cpp/h and FTPTransferer.cpp/h from the test application in your application and #include "FTPTransferDlg.h" in whichever files you want to use the class in. You should also copy over all the "IDS_FTPTRANSFER_.." string resources, the IDD_FTPTRANSFER dialog resource and the IDR_FTPTRANSFER_ANIMATION "avi" resource to your application. Then to bring up the dialog to upload / download a specific file, just use some code like the following:
  
  CFTPTransferDlg dlg;
  dlg.m_sServer = _T("ftp.some-site.com");
  dlg.m_sRemoteFile = _T("/somefile.ext");
  dlg.m_sLocalFile = _T("c:\\somfile.ext");
  dlg.m_bDownload = true;
  dlg.m_bBinary = true;
  if (dlg.DoModal() == IDOK)
      AfxMessageBox("File was downloaded successfully");
• Alternatively you can use the CFTPTransferer class (which CFTPTransferDlg uses internally) in a synchronous non-UI manner as follows:
  
  CFTPTransferer transfer;
  transfer.m_sServer = _T("ftp.some-site.com");
  transfer.m_sRemoteFile = _T("/somefile.ext");
  transfer.m_sLocalFile = _T("c:\\somfile.ext");
  transfer.m_bDownload = true;
  transfer.Transfer();
  
  

  To use the CFTPTransferer class you do not need to include the FTPTransferDlg.cpp/h files in your project as you instead simply include just FTPTransferer.cpp/h from the test application in your project and #include "FTPTransferer.h" in whichever files you want to use the class in. If you only want to use CFTPTransferer and not CFTPTransferDlg, then you only need to copy the IDS_FTPTRANSFER_..." string resources and not the dialog resource or avi resource to your application.

• For further examples on using the code, please take a look at the CFTPDlg::OnDownload()  and CFTPDlg::OnUpload code in the sample application.
• As of v1.18, the code at a minimum requires VC 2017 to compile.

Contacting the Author

PJ Naughter
Email: pjna@naughter.com
Web: http://www.naughter.com
17 April 2022