(Unicode C) ProgressMonSize Property

Demonstrates the case where the ProgressMonSize property is required to monitor the progress of FTP downloads.

When a file is downloaded, most FTP servers will indicate the file size in the intermediate "150" response. For example:

RETR hamlet.xml
150 Opening BINARY mode data connection for hamlet.xml (279658 Bytes).
226 Transfer complete.

However, some FTP servers do not provide the file size. For example, from a FileZilla server:

RETR files.txt
150 Connection accepted
226 Transfer OK

If the file size is not present, the component does not know how many bytes are forthcoming, and therefore it is not possible to monitor percentage completion progress -- unless the application provides a little help by setting the ProgressMonSize property just prior to calling GetFile.

The application should set the ProgressMonSize to the size indicated by GetSizeByName as demonstrated in this example.

Chilkat C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <C_CkFtp2W.h>

BOOL ftp_PercentDone(int percentDone)
    {
    wprintf(L"Percent Done: %d\n",percentDone);
    return FALSE;
    }

void ftp_ProgressInfo(const wchar_t *name, const wchar_t *value)
    {
    wprintf(L"%s: %s\n",name,value);
    }

void ChilkatSample(void)
    {
    HCkFtp2W ftp;
    BOOL (*fnftpPercentDone)(int percentDone) = ftp_PercentDone;
    void (*fnftpProgressInfo)(const wchar_t *name, const wchar_t *value) = ftp_ProgressInfo;
    BOOL success;
    const wchar_t *localFilename;
    const wchar_t *remoteFilename;
    int fileSize;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    ftp = CkFtp2W_Create();
    CkFtp2W_setPercentDone(ftp, fnftpPercentDone);
    CkFtp2W_setProgressInfo(ftp, fnftpProgressInfo);

    CkFtp2W_putHostname(ftp,L"ftp.example.com");
    CkFtp2W_putUsername(ftp,L"login");
    CkFtp2W_putPassword(ftp,L"password");

    CkFtp2W_putKeepSessionLog(ftp,TRUE);

    // Connect and login to the FTP server.
    success = CkFtp2W_Connect(ftp);
    if (success != TRUE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    // Change to the remote directory where the file is located.
    // This step is only necessary if the file is not in the root directory
    // for the FTP account.
    success = CkFtp2W_ChangeRemoteDir(ftp,L"junk");
    if (success != TRUE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    // Download a file.
    localFilename = L"hamlet.xml";
    remoteFilename = L"hamlet.xml";

    // If the FTP server does not supply the file size in the "150"
    // intermediate response (to the RETR command), then tell
    // the component how many bytes are forthcoming (if your
    // application wishes to monitor the progress as a percentage
    // completion).
    fileSize = CkFtp2W_GetSizeByName(ftp,remoteFilename);
    CkFtp2W_putProgressMonSize(ftp,fileSize);

    success = CkFtp2W_GetFile(ftp,remoteFilename,localFilename);
    if (success != TRUE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    wprintf(L"%s\n",CkFtp2W_sessionLog(ftp));

    CkFtp2W_Disconnect(ftp);


    CkFtp2W_Dispose(ftp);

    }