C

Upload (Append) Email to an IMAP Mailbox and get the UID of the Appended Email

Upload / append an email to an IMAP mailbox and get the UID of the appended email. C

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkImap imap;
    const char *cap;
    HCkEmail email;
    int uidNext;

    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,"imap.example.com");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

    //  Login
    success = CkImap_Login(imap,"myLogin","myPassword");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

    //  Check the capabilities of the IMAP server.
    cap = CkImap_capability(imap);
    printf("IMAP capabilities: %s\n",cap);

    //  If the capabilities string contains the substring "UIDPLUS", then 
    //  the UID of the appended email will be available in the AppendUid property (see below).

    //  For example, the GMail IMAP server has these capabilities (at this current time)
    //  * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN 
    //  X-GM-EXT-1 UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT 
    //  APPENDLIMIT=35882577 LIST-EXTENDED LIST-STATUS

    email = CkEmail_Create();

    //  Load the email from a .eml file.
    success = CkEmail_LoadEml(email,"myEmail.eml");
    if (success != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

    success = CkImap_AppendMail(imap,"Inbox",email);
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

    //  If the IMAP server supports the UIDPLUS extension, then the 
    //  imap.AppendUid will contain the UID of the appended email.
    //  Otherwise AppendUid will be 0.
    printf("UID of appended email: %d\n",CkImap_getAppendUid(imap));

    //  If the IMAP server does NOT have UIDPLUS, then a program can 
    //  first select the mailbox, get the value of the UidNext property,
    //  and then append.  The appended email SHOULD have a UID equal to 
    //  the UidNext that was obtained just prior to appending (assuming no other
    //  program is simultaneously appending an email to the same mailbox).

    //  Note: It is not required to select a mailbox to append.  The select is only
    //  done for the purpose of obtaining the UIDNEXT value.
    success = CkImap_SelectMailbox(imap,"Inbox");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

    uidNext = CkImap_getUidNext(imap);

    success = CkImap_AppendMail(imap,"Inbox",email);
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

    printf("The UID of the appended email SHOULD be %d\n",uidNext);

    printf("Email uploaded to Inbox!\n");

    //  Disconnect from the IMAP server.
    success = CkImap_Disconnect(imap);


    CkImap_Dispose(imap);
    CkEmail_Dispose(email);

    }