EmailSend (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

EmailReadMessageHeader

EmailReadNext

EmailReadNextHeader

EmailReadPrevious

EmailReadPreviousHeader

EmailStartIMAPSession

EmailStartNotesSession

EmailStartOutlookSession

EmailStartPOP3Session

EmailStartSMTPSession

The email structure
Asynchronous mode

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

EmailSend (Function)

In french: EmailEnvoie

Sends an email via the SMTP protocol while controlling the "buffer" of the email.

This function is an advanced function used to entirely configure the email sent. This function must only be used to manage the specific emails not managed by EmailSendMessage. For more details, see Writing an email.

Remark: The entire email description can be found in the reference documents of the Internet standard: RFC822 and RFC2045 to RFC2049. These documents are available on Internet (use a search engine with the references of the documents).

Versions 15 and later
You also have the ability to use the emailSMTPSession and Email variables as well as EmailImportSource to send a message while controlling the source of the message.

New in version 15
You also have the ability to use the emailSMTPSession and Email variables as well as EmailImportSource to send a message while controlling the source of the message.

You also have the ability to use the emailSMTPSession and Email variables as well as EmailImportSource to send a message while controlling the source of the message.

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

See additional examples

// Initialize the email structure
Email.NbRecipient = 1
Email.Recipient = "support_test@pcsoft_test.fr"
Email.Sender = "customer@company.fr"
Email.Message = "Auto Email Test"

// Build the message
IF EmailBuildSource() = False THEN
Error(ErrorInfo())
RETURN
END

IF fSaveText("C:\MyEmails\EmailContent.txt", Email.Source) = False THEN
Error(ErrorInfo())
ELSE
EmailSend("SMTPSession", "C:\MyEmails\EmailContent.txt")
IF ErrorOccurred = True THEN
Error(ErrorInfo())
END
END
END

Syntax

<Result> = EmailSend(<Username> , <File name>)

<Result>: Boolean

True if the function was successfully run,
False otherwise. To get the details of the error, use ErrorInfo with the errMessage constant.

<Username>: Character string

Identifies the user session. Corresponds to the username that was used to start the email session (EmailStartSession).

<File name>: Character string

Identifies the file containing the entire email formatted according to the parameters expected by the SMTP server.

Remarks

The email structure

When sending the email, only the variables of the email structure required by the SMTP protocol are taken into account. The other variables are ignored.

Remark: For more details, see The email structure.

Asynchronous mode

If the session was started in asynchronous mode (EmailStartSession and EmailStartSMTPSession), EmailSend creates an identifier for each email sent.

This identifier is stored in the Email.MailIdentifier variable and can be used with EmailStatus to get the current status of the outgoing email.

Component: wd270com.dll