<emailSMTPSession variable>.SendMessage (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Communication / Managing emails

Progress Bar

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<emailSMTPSession variable>.SendMessage (Function)

In french: <Variable emailSessionSMTP>.EnvoieMessage

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

Attention Before sending the Email, it is necessary to:

Start a session with <emailSMTPSession variable>.StartSession.
Fill a variable of type Email or structure Email with the message (sender, recipient, etc.).

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

Example

Sending a message by SMTP

// Ouverture d'une session SMTP
MaSession is emailSMTPSession
MaSession.ServerAddress = "smtp.masociete.fr"
MaSession.StartSession()

// Construction d'un email
MonMessage is Email
MonMessage.Sender = "service_commande@masociete.fr"
MonMessage.Recipient.Add("client@societe.com")
MonMessage.Subject = SAI_SujetEmail
MonMessage.Message = SAI_TexteEmail

// Envoi du message
MaSession.SendMessage(MonMessage)

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 more details on 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 username that was used to start the email session (<emailSMTPSession variable>.StartSession or EmailStartSMTPSession).
a variable of type emailSMTPSession.

<Email>: Optional Email variable

Name of the Email variable corresponding to the email to be sent. If this parameter is not specified, the information contained in the Email structure is used.
This parameter is not available.

<Advanced options>: Optional Integer constant

Combination of following constants:
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.

Remarks

Progress Bar

To follow the sending progress, use EmailProgressBar.

Component: wd300com.dll