Delphi DLL 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 DLL

var
success: Boolean;
imap: HCkImap;
fetchUids: Boolean;
messageSet: HCkMessageSet;
bundle: HCkEmailBundle;
headersOnly: Boolean;
email: HCkEmail;
i: Integer;
numEmails: Integer;

begin
success := False;

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

imap := CkImap_Create();

//  Indicate that STARTTLS should be used to convert
//  to a secure TLS/SSL connection:
CkImap_putStartTls(imap,True);
CkImap_putPort(imap,143);

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

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

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

//  Select an IMAP mailbox
success := CkImap_SelectMailbox(imap,'Inbox');
if (success = False) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

//  Get the message IDs of all the emails in the mailbox
fetchUids := True;
messageSet := CkMessageSet_Create();
success := CkImap_QueryMbx(imap,'ALL',fetchUids,messageSet);
if (success = False) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

//  Fetch the emails into a bundle object:
bundle := CkEmailBundle_Create();
headersOnly := False;
success := CkImap_FetchMsgSet(imap,headersOnly,messageSet,bundle);
if (success = False) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

//  Loop over the bundle and display the FROM and SUBJECT of each.
email := CkEmail_Create();
i := 0;
numEmails := CkEmailBundle_getMessageCount(bundle);
while i < numEmails do
  begin
    CkEmailBundle_EmailAt(bundle,i,email);

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

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

CkImap_Dispose(imap);
CkMessageSet_Dispose(messageSet);
CkEmailBundle_Dispose(bundle);
CkEmail_Dispose(email);