C

Async Upload (Append) Email to an IMAP Mailbox

Use the AppendMailAsync method call to append an email to an IMAP mailbox. C

#include <C_CkImap.h>
#include <C_CkEmail.h>
#include <C_CkTask.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkImap imap;
    HCkEmail email;
    HCkTask task;

    success = FALSE;

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

    imap = CkImap_Create();

    //  Connect to an IMAP server.
    //  Use TLS
    CkImap_putSsl(imap,TRUE);
    CkImap_putPort(imap,993);
    success = CkImap_Connect(imap,"MY-IMAP-DOMAIN");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

    //  Login
    success = CkImap_Login(imap,"MY-IMAP-LOGIN","MY-IMAP-PASSWORD");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

    //  Create a simple email with 2 recipients.
    email = CkEmail_Create();
    CkEmail_putFrom(email,"support@chilkatsoft.com");
    CkEmail_AddTo(email,"Chilkat Sales","sales@chilkatsoft.com");
    CkEmail_AddTo(email,"Chilkat GMail","chilkat.support@gmail.com");
    CkEmail_putBody(email,"This is a test email.");
    CkEmail_putSubject(email,"This is a test email.");

    //  Imagine we've sent this email via SMTP, and now we want to 
    //  save the email to our "Sent" mailbox.  On GMail, the mailbox name
    //  for sent email is "[Gmail]/Sent Mail".

    //  Call the async version of the AppendMail method to return a task object.
    task = CkImap_AppendMailAsync(imap,"[Gmail]/Sent Mail",email);
    if (CkImap_getLastMethodSuccess(imap) != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

    //  Schedule the task for running on the thread pool.  This changes the task's state
    //  from Inert to Live.  The task is now running...
    success = CkTask_Run(task);
    if (success != TRUE) {
        printf("%s\n",CkTask_lastErrorText(task));
        CkTask_Dispose(task);
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

    //  -------------------------------------------------------------------------------
    //  The following is a general note that applies to all programming languages:
    //  -------------------------------------------------------------------------------
    //  Your application can keep a reference to the task object and periodically check back later to see if it's finished.
    //  If your programming language is one that supports callbacks, then the TaskCompleted callback can
    //  be setup to be called when the task completes.  (See the "Async" category on example-code.com for more information.)
    //  
    //  NOTE: This is very important:  A TaskCompleted callback runs in the background thread.  
    //  (All callbacks from an async task, such as AbortCheck, PercentDone, ProgressInfo, etc. are in the background thread.) 
    //  An application that uses TaskCompleted must be very careful.  
    //  For example, user interface elements (such as labels, text boxes, etc.) may not be directly
    //  accessible from a background thread, and could crash the application if directly accessed.  Also, attempting to debug
    //  code running in a background thread from an IDE, especially an older IDE (such as VB6) is likely to crash the IDE.


    CkImap_Dispose(imap);
    CkEmail_Dispose(email);

    }