Unicode 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. Unicode C

#include <C_CkImapW.h>
#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkImapW imap;
    const wchar_t *cap;
    HCkEmailW email;
    int uidNext;

    success = FALSE;

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

    imap = CkImapW_Create();

    // Connect to an IMAP server.
    // Use TLS
    CkImapW_putSsl(imap,TRUE);
    CkImapW_putPort(imap,993);
    success = CkImapW_Connect(imap,L"imap.example.com");
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    // Login
    success = CkImapW_Login(imap,L"myLogin",L"myPassword");
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    // Check the capabilities of the IMAP server.
    cap = CkImapW_capability(imap);
    wprintf(L"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 = CkEmailW_Create();

    // Load the email from a .eml file.
    success = CkEmailW_LoadEml(email,L"myEmail.eml");
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkImapW_Dispose(imap);
        CkEmailW_Dispose(email);
        return;
    }

    success = CkImapW_AppendMail(imap,L"Inbox",email);
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        CkEmailW_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.
    wprintf(L"UID of appended email: %d\n",CkImapW_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 = CkImapW_SelectMailbox(imap,L"Inbox");
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        CkEmailW_Dispose(email);
        return;
    }

    uidNext = CkImapW_getUidNext(imap);

    success = CkImapW_AppendMail(imap,L"Inbox",email);
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        CkEmailW_Dispose(email);
        return;
    }

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

    wprintf(L"Email uploaded to Inbox!\n");

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


    CkImapW_Dispose(imap);
    CkEmailW_Dispose(email);

    }