C

Forward an Email using CreateForward

See more Email Object Examples

Reads an email from an IMAP server, creates a forward version of the email using the CreateForward method, and sends the email to another recipient. C

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkImap imap;
    int numEmails;
    HCkEmail email;
    HCkEmail eForward;
    HCkStringBuilder sbHtmlBody;
    HCkStringBuilder sbPtBody;
    HCkMailMan mailman;

    success = FALSE;

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

    // Read the 1st (most recent) email in an Inbox.
    imap = CkImap_Create();

    // Connect to an IMAP server.
    CkImap_putSsl(imap,TRUE);
    CkImap_putPort(imap,993);
    success = CkImap_Connect(imap,"imap.example.com");
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

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

    // Select an IMAP mailbox
    success = CkImap_SelectMailbox(imap,"Inbox");
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

    numEmails = CkImap_getNumMessages(imap);

    // Fetch the email at the last sequence number.
    // (We are assuming the Inbox has at least 1 email)

    email = CkEmail_Create();
    success = CkImap_FetchEmail(imap,FALSE,numEmails,FALSE,email);
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

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

    printf("%s\n",CkEmail_subject(email));

    eForward = CkEmail_Create();
    success = CkEmail_ToForward(email,eForward);
    if (success == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        CkEmail_Dispose(eForward);
        return;
    }

    // The eForward email has no To or CC recipients yet.
    // Add one or more..
    CkEmail_AddTo(eForward,"Joe","joe@example.com");

    // We also need to specify the From name/address.
    CkEmail_putFromAddress(eForward,"matt@someMailServer.com");
    CkEmail_putFromName(eForward,"Matt");

    // If we wish to add text at the start of the email body:
    sbHtmlBody = CkStringBuilder_Create();
    if (CkEmail_HasHtmlBody(eForward) == TRUE) {
        CkStringBuilder_Append(sbHtmlBody,CkEmail_getHtmlBody(eForward));
        CkStringBuilder_Prepend(sbHtmlBody,"<p>Hello, this is an email I'm forwarding to you...</p>");
        CkEmail_SetHtmlBody(eForward,CkStringBuilder_getAsString(sbHtmlBody));
    }

    sbPtBody = CkStringBuilder_Create();
    if (CkEmail_HasPlainTextBody(eForward) == TRUE) {
        CkStringBuilder_Append(sbPtBody,CkEmail_getPlainTextBody(eForward));
        CkStringBuilder_Prepend(sbPtBody,"Hello, this is an email I'm forwarding to you...\r\n\r\n");
        CkEmail_SetTextBody(eForward,CkStringBuilder_getAsString(sbPtBody),"text/plain");
    }

    // We could save the .eml, then double-click on it to view in our mail program, such as Outlook or Thunderbird..
    CkEmail_SaveEml(eForward,"qa_output/forward.eml");

    // We could send (forward) the email..
    mailman = CkMailMan_Create();

    CkMailMan_putSmtpHost(mailman,"smtp.example.com");
    CkMailMan_putSmtpUsername(mailman,"myLogin");
    CkMailMan_putSmtpPassword(mailman,"myPassword");
    CkMailMan_putSmtpPort(mailman,587);
    CkMailMan_putStartTLS(mailman,TRUE);

    success = CkMailMan_SendEmail(mailman,eForward);
    if (success == FALSE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        CkEmail_Dispose(eForward);
        CkStringBuilder_Dispose(sbHtmlBody);
        CkStringBuilder_Dispose(sbPtBody);
        CkMailMan_Dispose(mailman);
        return;
    }

    success = CkMailMan_CloseSmtpConnection(mailman);
    if (success != TRUE) {
        printf("Connection to SMTP server not closed cleanly.\n");
    }

    printf("Mail Sent!\n");


    CkImap_Dispose(imap);
    CkEmail_Dispose(email);
    CkEmail_Dispose(eForward);
    CkStringBuilder_Dispose(sbHtmlBody);
    CkStringBuilder_Dispose(sbPtBody);
    CkMailMan_Dispose(mailman);

    }