(Objective-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.

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

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

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

CkoImap *imap = [[CkoImap alloc] init];

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

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

// Check the capabilities of the IMAP server.
NSString *cap = [imap Capability];
NSLog(@"%@%@",@"IMAP capabilities: ",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

CkoEmail *email = [[CkoEmail alloc] init];

// Load the email from a .eml file.
success = [email LoadEml: @"myEmail.eml"];
if (success != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

success = [imap AppendMail: @"Inbox" email: email];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    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.
NSLog(@"%@%d",@"UID of appended email: ",[imap.AppendUid intValue]);

// 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 = [imap SelectMailbox: @"Inbox"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

int uidNext = [imap.UidNext intValue];

success = [imap AppendMail: @"Inbox" email: email];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

NSLog(@"%@%d",@"The UID of the appended email SHOULD be ",uidNext);

NSLog(@"%@",@"Email uploaded to Inbox!");

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