CFTPTransferDlg provides an MFC dialog which performs
FTP uploads and downloads
similar to the Internet Explorer download dialog as shown below:
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();
The enclosed zip file
contains source code for the classes and also includes a VC 6 project file to build a
simple dialog based app which performs FTP uploads and downloads to any FTP
server.
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.
Updates
v1.0 (4 January 2000)
V1.01 (31 October 2000)
- Added a m_bPromptOverwrite variable
- Fixed a bug in the way the progress control was being updated.
10 December 2000
- Updated distribution to describe when you need to
"#include" and link to.
V1.02 (11 June 2001)
- Updated copyright details.
- Now provides Bandwidth throtling support. Thanks to
Karim Mribti for this good addition.
- Minor code tidy up thanks to BoundsChecker
- m_bPromptForOverwrite now works correctly for
downloads as well as uploads
- Fixed a problem with the progress control not
updating correctly
V1.03 (10 October 2001)
- Fixed a problem where old style MFC exception handling was being used instead of C++ standard.
V1.04 (17 October 2001)
- Now includes support for PASV
- Fixed a Unicode issue in
CFTPTransferDlg::OnStatusCallBack
- Support for precongfigured or direct settings.
- Support for proxies
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.06 (20 April 2002)
- Modified the code to correctly support FTP
resumes. Feeedback from jony for reporting this issue.
- Fixed a bug in the call to AfxBeginThread.
5 June 2002
- Renamed some string resources used by the class to maintain naming consistency.
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.
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.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.10 (14 April 2007)
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.12 (10 June 2007)
- Minor bug fix to CFTPTransferDlg::SetTimeLeft to correctly handle 64 bit
integer parameter.
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.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.