TIdSMTP = class(TIdMessageClient)

• RFC 821 - Simple Mail Transfer Protocol [SMTP] (http://www.rfc-editor.org/rfc/rfc821.txt)

• RFC 1869 - SMTP Service Extensions (http://www.rfc-editor.org/rfc/rfc1869.txt)

• RFC 2554 - SMTP Service Extension for Authentication (http://www.rfc-editor.org/rfc/rfc2554.txt)

Use TIdPOP3 or TIdIMAP4 to retrieve E-Mail messages from a mail server to the user's computer.

property AuthenticationType: TAuthenticationType;

• atNone - no authentication is required.

• atLogin - simple username and password authentication is required (AUTH LOGIN).

You can find the authentication mechanisms supported on the E-Mail server identified in Host by using AuthSchemesSupported.

property AuthSchemesSupported: TStringList;

Note: Any given SMTP server can support authentication mechanisms which may not be implemented in TIdSMTP.

property HeloName: string;

property MailAgent: string;

property Password;

property UseEhlo: Boolean;

UseEhlo is used in the Connect method prior to sending the value from HeloName (or LocalName) to the SMTP server. When UseEhlo is True, the client identification is sent using the SMTP EHLO command. Authentication types supported by the server are captured upon successful completion of the EHLO command. When UseEhlo is False, the SMTP HELO command is used for client identification.

Note: Changing the value of UseEhlo from True to False forces the AuthenticationType property to be reset to the value atNone. An application must set the correct value for AuthenticationType after changing UseEhlo from True to False.

property Username;

procedure Assign(Source: TPersistent); override;

Assign will load the following property values:

• AuthenticationType

• Host

• MailAgent

• Password

• Port

• Username

function Authenticate: Boolean; virtual;

You must specify the AuthenticationType before calling the Authenticate method. Authenticate should be called only once for a SMTP session.

Send will also call Authenticate before transmission of an E-Mail message, if the SMTP session has not been authenticated.

When AuthenticationType is atLogin, Authenticate sends the SMTP AUTH LOGIN command followed by the Base64-encoded values for Username and Password to the server.

procedure Connect(const ATimeout: Integer = IdTimeoutDefault); override;

After establishing the socket connection, Connect will clear AuthSchemesSupported. Connect hails the server using either the HeloName or the LocalName properties using either the SMTP EHLO or HELO commands. When the EHLO command is supported on the SMTP server, AuthSchemesSupported will be loaded.

If an exception is raised in Connect, the SMTP client will call Disconnect and the exception will be re-raised.

constructor Create(AOwner: TComponent); override;

destructor Destroy; override;

procedure Disconnect; override;

procedure Expand(AUserName: String; AResults: TStrings); virtual;

The following is an example of successful result values that might be returned in AResults when using Expand with the Username 'Example-People':

    Jon Postel 
    Fred Fonebone 
    Sam Q. Smith 
    Quincy Smith <@USC-ISIF.ARPA:Q-Smith@ISI-VAXA.ARPA>
    
    

Use Verify to validate an individual name or address on the SMTP server.

class procedure QuickSend(const AHost: String; const ASubject: String; const ATo: String; const AFrom: String; const AText: String);

Parameters for the method are used to construct a TIdMessage instance, connect and send the message to the SMTP server, and to Disconnect from the SMTP server. The following is an example of using QuickSend with pre-defined application variables:

  try
    ASmtp.QuickSend(SMailhost, SSubject, SUserAccount,
      SContactAccount, ABody.Text);
  except on E:
    do DoReminderTransmitError(E);
  end;

procedure Send(AMsg: TIdMessage); virtual;

Send transmits RFC 822 message headers to the SMTP server, including From, Recipients, Carbon-Copy recipients, and Blind Carbon-Copy recipients before sending the data and extra RFC 822 message headers for the message. Send inserts the value in MailAgent header as the first values in the data for the message. Send terminates transfer of data to the SMTP server using the '.' end-of-transmission marker.

function Verify(AUserName: String): String; virtual;

The following is an example of the value returned from a successful Verify command request using 'Smith' in AUsername:

    Fred Smith