(Objective-C) IMAP Capability

Demonstrates how to send the CAPABILITY command to request a listing of capabilities that the IMAP server supports. A capability name which begins with "AUTH=" indicates that the server supports that particular authentication mechanism.

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

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

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

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

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

// Authenticate
success = [imap Login: @"MY-IMAP-LOGIN" password: @"MY-IMAP-PASSWORD"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Get the list of capabilities:
NSString *caps = [imap Capability];
NSLog(@"%@%@",@"Capabilities: ",caps);

// Here is an example of the string returned:
// * 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

// Chilkat v9.5.0.58 introduces the HasCapability method to
// check to see if a particular capability exists:
if ([imap HasCapability: @"QUOTA" capabilityResponse: caps] == YES) {
    NSLog(@"%@",@"IMAP server supports the QUOTA extension.");
}

if ([imap HasCapability: @"IDLE" capabilityResponse: caps] == YES) {
    NSLog(@"%@",@"IMAP server supports IDLE.");
}

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