Create an Inline-Forward Email

See more Email Object Examples

Demonstrates the Chilkat Email.ToForward method, which creates an inline-forward email based on this email. The forward is returned in the argument, and the source email is not modified. The returned email can be edited — adding recipients, prepending a note — before sending. This example forwards a message and adds a recipient.

Background: An inline forward quotes the original message's content within the body of the new message — the familiar "---------- Forwarded message ----------" style — as opposed to attaching the original as a message/rfc822 part (which AttachEmail does). Chilkat assembles the quoted body and headers for you, leaving the new message ready to address and send.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmail email;
    HCkEmail fwd;

    success = FALSE;

    //  Demonstrates the ToForward method, which creates an inline-forward email based on this
    //  email.  The forward is returned in the argument; the source email is not modified.

    email = CkEmail_Create();
    CkEmail_putSubject(email,"Quarterly results");
    CkEmail_putFrom(email,"alice@example.com");
    CkEmail_AddTo(email,"Bob","bob@example.com");
    CkEmail_putBody(email,"Here are the quarterly results.");

    //  Create an inline-forward email from this message.
    fwd = CkEmail_Create();

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

    //  The forward can be edited to add recipients before sending.
    CkEmail_AddTo(fwd,"Carol","carol@example.com");

    printf("%s\n",CkEmail_getMime(fwd));


    CkEmail_Dispose(email);
    CkEmail_Dispose(fwd);

    }