<emailSMTPSession variable>.SendMessage (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

See also

<emailSMTPSession variable>.SendMessage (Function)

In french: <Variable emailSessionSMTP>.EnvoieMessage

Sends an email using SMTP: the email is directly sent to the server. The email is actually sent when disconnecting from the SMTP server (i.e. when the session is closed).

Caution: Before sending the email, you must:

Start a session with emailSMTPSession Variable >.OpenSession.
Fill an Email variable or the Email structure with the message (sender, recipient, ...).

In this version, the emails can be sent via the SMTP protocol only.

In this version, the emails can be sent via the SMTP protocol only. Before sending this email, there is no need to start a session with emailSMTPSession Variable >.OpenSession. To actually send the email, the SMTP server to use must be supplied to the PHP engine. It must be specified in the "SMTP =" entry of PHP.INI file.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 22 and later

This function is now available in Android Widget mode.

This function is now available for Android applications.

New in version 22

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available for Android applications.

Example

Sending a message by SMTP

// Start an SMTP session
MySession is emailSMTPSession
MySession.ServerAddress = "smtp.mycompany.us"
MySession.StartSession()

// Build an email
MyMessage is Email
MyMessage.Sender = "ordering_department@mycompany.fr"
MyMessage.Recipient.Add("customer@company.com")
MyMessage.Subject = EDT_EmailSubject
MyMessage.Message = "EDT_EmailText"

// Send the message
MySession.SendMessage(MyMessage)

Syntax

Sending an email using SMTP Hide the details

<Result> = <Session>.SendMessage([<Email> [, <Advanced options>]])

<Result>: Boolean

True if the message was sent to the SMTP server,
False otherwise. To get the details of the error, use ErrorInfo with the errMessage constant.
If an error occurs, the content of Email.Error variable must be checked.

<Session>: Control name

Identifies the user session. Corresponds to:
the user name that was used to start the email session (emailSMTPSession Variable >.OpenSession or EmailStartSMTPSession).
Versions 15 and later
an emailSMTPSession variable.
New in version 15
an emailSMTPSession variable.
an emailSMTPSession variable.
This parameter is not available.

<Email>: Optional Email variable

Versions 15 and later
Name of the Email variable corresponding to the email to send. If this parameter is not specified, the information found in the Email structure is used.
This parameter is not available.
New in version 15
Name of the Email variable corresponding to the email to send. If this parameter is not specified, the information found in the Email structure is used.
This parameter is not available.
Name of the Email variable corresponding to the email to send. If this parameter is not specified, the information found in the Email structure is used.
This parameter is not available.

<Advanced options>: Optional Integer constant

Combination of following constants:
Versions 15 and later
emailOptionEncodeHeader
New in version 15
emailOptionEncodeHeader
emailOptionEncodeHeader Encodes the message headers in Quoted-Printable if necessary.
The headers of messages are not encoded by default. This constant prevents the reception of email with wrongly decoded accented characters.
emailOptionMessageID Takes the Email.MessageID variable into account to generate the email. This option is ignored if this variable is not specified.
This option is an advanced option.
emailOptionReference Takes the Email.Reference variable into account to generate the email. This option is ignored if this variable is not specified.
This option is an advanced option.
This parameter is not available.

Remarks

Asynchronous mode

If the session was started in asynchronous mode (emailSMTPSession Variable >.OpenSession and EmailStartSMTPSession), <emailSMTPSession variable>.SendMessage creates an identifier for each email sent.

The email identifier is stored in the Email.MailIdentifier variable and can be used by EmailStatus to determine the current status of the outgoing email (sent, in progress, etc.).

Processing the errors in asynchronous mode: <emailSMTPSession variable>.SendMessage returns True if the email is placed in the email spooler, False if the spooler cannot be contacted. To find out whether the email was sent, you must use EmailStatus.

Progress Bar

To follow the sending progress, use EmailProgressBar.

Component: wd260com.dll