Delphi ActiveX Requires Chilkat v11.0.0+

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.

Delphi ActiveX

var
success: Integer;
imap: TChilkatImap;
fetchUids: Integer;
messageSet: TMessageSet;
bundle: TChilkatEmailBundle;
headersOnly: Integer;
email: TChilkatEmail;
i: Integer;
numEmails: Integer;

begin
success := 0;

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

imap := TChilkatImap.Create(Self);

//  Indicate that STARTTLS should be used to convert
//  to a secure TLS/SSL connection:
imap.StartTls := 1;
imap.Port := 143;

//  Connect to an IMAP server and convert the connection
//  to TLS/SSL via STARTTLS.
success := imap.Connect('imap.example.com');
if (success = 0) then
  begin
    Memo1.Lines.Add(imap.LastErrorText);
    Exit;
  end;

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

//  Login
success := imap.Login('myLogin','myPassword');
if (success = 0) then
  begin
    Memo1.Lines.Add(imap.LastErrorText);
    Exit;
  end;

//  Select an IMAP mailbox
success := imap.SelectMailbox('Inbox');
if (success = 0) then
  begin
    Memo1.Lines.Add(imap.LastErrorText);
    Exit;
  end;

//  Get the message IDs of all the emails in the mailbox
fetchUids := 1;
messageSet := TMessageSet.Create(Self);
success := imap.QueryMbx('ALL',fetchUids,messageSet.ControlInterface);
if (success = 0) then
  begin
    Memo1.Lines.Add(imap.LastErrorText);
    Exit;
  end;

//  Fetch the emails into a bundle object:
bundle := TChilkatEmailBundle.Create(Self);
headersOnly := 0;
success := imap.FetchMsgSet(headersOnly,messageSet.ControlInterface,bundle.ControlInterface);
if (success = 0) then
  begin
    Memo1.Lines.Add(imap.LastErrorText);
    Exit;
  end;

//  Loop over the bundle and display the FROM and SUBJECT of each.
email := TChilkatEmail.Create(Self);
i := 0;
numEmails := bundle.MessageCount;
while i < numEmails do
  begin
    bundle.EmailAt(i,email.ControlInterface);

    Memo1.Lines.Add(email.From);
    Memo1.Lines.Add(email.Subject);
    Memo1.Lines.Add('--');
    i := i + 1;
  end;

//  Disconnect from the IMAP server.
success := imap.Disconnect();