Pascal (Lazarus/Delphi)

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.

Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.EmailBundle,
  Chilkat.Imap,
  Chilkat.Email,
  Chilkat.MessageSet;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  imap: TImap;
  fetchUids: Boolean;
  messageSet: TMessageSet;
  bundle: TEmailBundle;
  headersOnly: Boolean;
  email: TEmail;
  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 := TImap.Create;

  //  Indicate that STARTTLS should be used to convert
  //  to a secure TLS/SSL connection:
  imap.StartTls := True;
  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 = False) then
    begin
      WriteLn(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 = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Select an IMAP mailbox
  success := imap.SelectMailbox('Inbox');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Get the message IDs of all the emails in the mailbox
  fetchUids := True;
  messageSet := TMessageSet.Create;
  success := imap.QueryMbx('ALL',fetchUids,messageSet);
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Fetch the emails into a bundle object:
  bundle := TEmailBundle.Create;
  headersOnly := False;
  success := imap.FetchMsgSet(headersOnly,messageSet,bundle);
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

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

      WriteLn(email.From);
      WriteLn(email.Subject);
      WriteLn('--');
      i := i + 1;
    end;

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


  imap.Free;
  messageSet.Free;
  bundle.Free;
  email.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.