EmailSend (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

EmailReadMessageHeader

EmailReadNext

EmailReadNextHeader

EmailReadPrevious

EmailReadPreviousHeader

EmailStartIMAPSession

EmailStartNotesSession

EmailStartOutlookSession

EmailStartPOP3Session

EmailStartSMTPSession

This content has been translated automatically. Click here to view the French version.

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. See Writing an email for more details.

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:\MesEmail with\ContenuEmail.txt", Email.Source) = False THEN
Error(ErrorInfo())
ELSE
EmailSend("SessionSMTP", "C:\MesEmails\ContenuEmail.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 find out the name of the error, use the function ErrorInfo with the constant errMessage.

<Username>: Character string (with quotes)

Identifies the user session. Corresponds to the user name used to open the Email session (EmailStartSession function).

<File name>: Character string (with quotes)

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: See The email structure for more details.

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 Variable Email.mail identifier and can be used with the EmailStatus function to find out the current sending report of the Email.

Component: wd260com.dll