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

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

BOOL success = NO;

//  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];
success = [imap Connect: @"imap.example.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;

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];