Unicode C

FTP Sync Download Tree w/ Must-Match Constraints

See more FTP Examples

Demonstrates how synchronize a directory tree in the download direction, but only for files matching a set of wildcard filenames.

Note: This example requires Chilkat v9.5.0.76 or greater.

Unicode C

#include <C_CkFtp2W.h>
#include <C_CkStringTableW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkFtp2W ftp;
    int mode;
    HCkStringTableW st;
    int numFiles;
    int i;
    const wchar_t *remoteFilename;

    success = FALSE;

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

    ftp = CkFtp2W_Create();

    CkFtp2W_putHostname(ftp,L"ftp.something.com");
    CkFtp2W_putUsername(ftp,L"my_login");
    CkFtp2W_putPassword(ftp,L"my_password");

    //  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;
    }

    //  Set the current remote directory to the root of
    //  the tree to be downloaded.
    success = CkFtp2W_ChangeRemoteDir(ftp,L"/subDir1");
    if (success != TRUE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    //  Possible synchronization modes are:
    //  mode=0: Download all files
    //  mode=1: Download all files that do not exist on the local filesystem.
    //  mode=2: Download newer or non-existant files.
    //  mode=3: Download only newer files. If a file does not already exist on the local filesystem, it is not downloaded from the server..
    //  mode=5: Download only missing files or files with size differences.
    //  mode=6: Same as mode 5, but also download newer files.

    //  This example will download all files, but only those files having filenames
    //  that match *.gif and *.eml

    //  Imagine our remote directory tree has these files and directories:

    //  	accentedLatin1.txt
    //  	accentedUtf8.txt
    //  	alice.key
    //  	anter_cert.pem
    //  	chiliPepper.gif
    //  	helloWorld.pdf
    //  	abc/chiliPepper.gif
    //  	abc/ghk/
    //  	data/chiliPepper.gif
    //  	data/xyz/dkimHtmlBody.txt
    //  	data/xyz/dkimVerifyTest.eml
    //  	data/xyz/emailForCreateDsn.eml
    //  	text/frenchUtf8.txt
    //  	text/helloWorld.txt
    //  	text/PolishEmailBody.txt
    //  	text/something/

    //  Indicate that we only want to create auto-create local directories (if needed)
    //  for the files that are actually downloaded.  If SyncCreateAllLocalDirs remains
    //  TRUE, then the corresponding local directory is created for each remote directory
    //  traversed regardless of whether files within are downloaded.
    CkFtp2W_putSyncCreateAllLocalDirs(ftp,FALSE);

    CkFtp2W_putSyncMustMatch(ftp,L"*.eml; *.gif");
    mode = 0;
    success = CkFtp2W_SyncLocalTree(ftp,L"c:/temp/subDir1",mode);
    if (success != TRUE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    success = CkFtp2W_Disconnect(ftp);

    //  Show the files downloaded.
    st = CkStringTableW_Create();
    CkFtp2W_GetSyncedFiles(ftp,st);

    numFiles = CkStringTableW_getCount(st);
    i = 0;

    while (i < numFiles) {
        wprintf(L"%s\n",CkStringTableW_stringAt(st,i));
        i = i + 1;
    }

    //  Output showing the files downloaded:

    //  chiliPepper.gif
    //  abc/chiliPepper.gif
    //  data/chiliPepper.gif
    //  data/xyz/dkimVerifyTest.eml
    //  data/xyz/emailForCreateDsn.eml


    CkFtp2W_Dispose(ftp);
    CkStringTableW_Dispose(st);

    }