Objective-C

Connect to an IMAP Server

Demonstrates the Chilkat Imap.Connect method, which establishes a TCP connection to the IMAP server but does not authenticate. The argument may be a hostname, IPv4, or IPv6 address; configure Ssl and Port first. This example connects with implicit TLS, then logs in and disconnects.

Background: IMAP (Internet Message Access Protocol) is the protocol for accessing mail that stays on the server — unlike POP3, which typically downloads and removes it. That server-side model is what lets multiple devices see the same mailboxes, folders, and read/unread state. A session starts by connecting (usually implicit TLS on port 993), then authenticating — Connect performs only the first step, so it is always followed by Login.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoImap.h>

BOOL success = NO;

//  Demonstrates the Imap.Connect method, which establishes a TCP connection to the IMAP
//  server but does not authenticate.  Call Login after connecting to authenticate.

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

//  Use implicit TLS on the standard IMAPS port.
imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];

//  Establish the connection to the IMAP server (no authentication yet).
success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

NSLog(@"%@",@"Connected to the IMAP server.");

//  Authenticate the session.
success = [imap Login: @"user@example.com" password: @"myPassword"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Disconnect when finished.
success = [imap Disconnect];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}