Objective-C

IMAP STARTTLS (Explicit TLS/SSL)

The StartTls property is set to force the Connect method to automatically convert an connection to TLS/SSL via the STARTTLS IMAP command.

This is also known as "explicit TLS/SSL" as opposed to "implicit TLS/SSL". With implicit TLS/SSL, the IMAP client connects on the well-known IMAP TLS/SSL port 993 and the secure channel is immediately established. With explicit TLS/SSL, the IMAP client connects on the typical non-secure port (143 usually) and the converts the connection via the STARTTLS command.

Objective-C

#import <CkoImap.h>
#import <CkoMessageSet.h>
#import <CkoEmailBundle.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];

//  Indicate that STARTTLS should be used to convert
//  to a secure TLS/SSL connection:
imap.StartTls = YES;
imap.Port = [NSNumber numberWithInt:143];

//  Connect to an IMAP server and convert the connection
//  to TLS/SSL via STARTTLS.
success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  The remainder of this example is the same as for 
//  non-TLS/SSL...

//  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;
}

//  Get the message IDs of all the emails in the mailbox
BOOL fetchUids = YES;
CkoMessageSet *messageSet = [[CkoMessageSet alloc] init];
success = [imap QueryMbx: @"ALL" bUid: fetchUids msgSet: messageSet];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Fetch the emails into a bundle object:
CkoEmailBundle *bundle = [[CkoEmailBundle alloc] init];
BOOL headersOnly = NO;
success = [imap FetchMsgSet: headersOnly msgSet: messageSet bundle: bundle];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Loop over the bundle and display the FROM and SUBJECT of each.
CkoEmail *email = [[CkoEmail alloc] init];
int i = 0;
int numEmails = [bundle.MessageCount intValue];
while (i < numEmails) {
    [bundle EmailAt: [NSNumber numberWithInt: i] email: email];

    NSLog(@"%@",email.From);
    NSLog(@"%@",email.Subject);
    NSLog(@"%@",@"--");
    i = i + 1;
}

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