Objective-C

Forward by Attaching the Existing Email to a New Email

See more Email Object Examples

Demonstrates how to forward an email by attaching the email to a new email.

This example reads an email from an IMAP server, attaches the email to a new email, and sends the new email.

Objective-C

#import <CkoImap.h>
#import <CkoEmail.h>
#import <CkoMailMan.h>

BOOL success = NO;

// 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.
CkoImap *imap = [[CkoImap alloc] init];

// Connect to an IMAP server.
imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];
success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Login
success = [imap Login: @"myLogin" password: @"myPassword"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Select an IMAP mailbox
success = [imap SelectMailbox: @"Inbox"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

int numEmails = [imap.NumMessages intValue];

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

CkoEmail *email = [[CkoEmail alloc] init];
success = [imap FetchEmail: NO msgId: numEmails bUid: NO email: email];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Disconnect from the IMAP server.
[imap Disconnect];

NSLog(@"%@",email.Subject);

// Create a new email.  The email we just read will be attached to this email.
CkoEmail *eForward = [[CkoEmail alloc] init];

[eForward AddTo: @"Joe" emailAddress: @"joe@example.com"];

eForward.FromAddress = @"matt@somewhere.com";
eForward.FromName = @"Matt";
eForward.Subject = @"This is an email with another email attached.";

[eForward SetHtmlBody: @"<p>Hello, this is an email I'm forwarding to you.  See the attached email.</p>"];

// Attach the email.
[eForward AttachEmail: email];

// We could save the .eml, then double-click on it to view in our mail program, such as Outlook or Thunderbird..
[eForward SaveEml: @"qa_output/forward.eml"];

// We could send (forward) the email..
CkoMailMan *mailman = [[CkoMailMan alloc] init];

mailman.SmtpHost = @"smtp.example.com";
mailman.SmtpUsername = @"myLogin";
mailman.SmtpPassword = @"myPassword";
mailman.SmtpPort = [NSNumber numberWithInt:587];
mailman.StartTLS = YES;

success = [mailman SendEmail: eForward];
if (success == NO) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

success = [mailman CloseSmtpConnection];
if (success != YES) {
    NSLog(@"%@",@"Connection to SMTP server not closed cleanly.");
}

NSLog(@"%@",@"Mail Sent!");