Properties specific to the description of Email variables

Name	Type used	Effect
ReturnReceipt	Boolean	Outbound, used to request a delivery receipt from the recipient (True). The recipient does not necessarily have to send a delivery receipt. Inbound, used to find out whether a delivery receipt was requested by the sender (True) or no (False). If a read receipt is requested, it has priority over the return receipt. This property is set to False by default. This property is not supported by Outlook in Windows.
SenderAddress	Character string	Address of sender. This address must be a valid email address (and only an email address). Remark: If the address contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage. In Outlook, this variable is ignored. The name of account for the current session is used to fill this variable. In Lotus, the Lotus login is used if the sender is not specified.
Versions 24 and later ReturnAddressError New in version 24 ReturnAddressError ReturnAddressError	Character string	Return address if an error occurred. This address is managed by the POP3, IMAP and SMTP protocols. Remark: If the address contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage. Not available.
Attach	Array of emailAttach	Contains the description of attached files. The number of attached files is unlimited. See emailAttach for more details. Remark: If the attachment is filled manually, don't forget to specify ..Name otherwise the image will not be transmitted in the email. Example: oEmail..Attach[1]..Content = fLoadBuffer(fDataDir() +  ["\"] + "Email\" + sCompanyLogo) oEmail..Attach[1]..ContentType = "image/gif" oEmail..Attach[1]..Name = "logo.gif"
Category	Character string	List of keywords associated with the email. The keywords are separated by semicolons. Remark: If one of the keywords contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage.
Cc	Array of character strings	Contains the addresses of recipients in copy: their name is displayed in the email received by the official recipients (..Recipient property). The addresses are limited to 127 characters. The number of recipients in copy is limited to 200. This limit can be exceeded in SMTP mode. However, some servers do not support the emails with an important number of recipients.
Bcc	Array of character strings	Contains the addresses of non-official recipients: their name is not displayed in the email received by the official recipients (..Recipient property). The addresses are limited to 127 characters. The number of non-official recipients is limited to 200. This limit can be exceeded in SMTP mode. However, some servers do not support the emails with an important number of recipients.
Versions 16 and later Certificate New in version 16 Certificate Certificate	Certificate	Certificate used to sign the email (header, content and attachments) before sending it. Versions 16 and later This property is not available. New in version 16 This property is not available. This property is not available.
Sensitivity	Integer constant	Type of confidentiality for the email. The possible values are as follows: emailCompanyConfidential: Used for the in-house emails for example. emailNoSensitivity (Default value): No confidentiality. emailPersonal: Used for the personal emails for example. emailPrivate: Used for the private emails for example. This property is not supported in Lotus Notes.
DispositionNotification	Boolean	Outbound, used to request a confirmation that the email was read by the recipient (True). The recipient does not necessarily have to send a read receipt. Inbound, used to find out whether a read receipt was requested by the sender (True) or not. If a read receipt is requested, it has priority over the return receipt. This property is set to False by default. This property is not supported in Lotus Notes. This property is supported by Outlook in Windows and by Outlook in Pocket.
ReceiveDate	Character string or DateTime variable	Date when the message was received.
Recipient	Array of character strings	Contains the addresses of main recipients. The number of recipients is limited to 20. This limit can be exceeded in SMTP mode. However, some servers do not support the emails with an important number of recipients.
Out	Boolean	Specifies whether a message was read on the server: False if the message was read. True if the message was not read.
Versions 19 and later Header New in version 19 Header Header	Array of emailHeader	Headers of email. This property is not available.
Sender	Character string	Address to which the answer to the message will be sent (up to 127 characters). Remark: If the sender contains special characters, accents, use the constant emailOptionEncode when sending the message with the function EmailSendMessage. In Outlook, this variable is ignored. The name of account for the current session is used to fill this variable. In Lotus, the Lotus login is used if the sender is not specified.
HTML	Character string	Message with HTML formatting. Limited to 4 GB. This property is supported in POP3/SMTP only.
ID	Character string	Unique email identifier. This identifier remains constant for the entire email lifetime. This identifier is initialized when sending the email (EmailSendMessage). Remark: If the identifier contains special characters, accents, use the constant emailOptionEncode when sending the message with the function EmailSendMessage. This property is supported by the Outlook messaging and by the Lotus Notes messaging only.
Versions 23 and later AsynchronousEmailIdentifier New in version 23 AsynchronousEmailIdentifier AsynchronousEmailIdentifier	Character string	Email identifier (asynchronous mode only). WEBDEV only This property is not available.
Message	Character string	Text of message (with simple text formatting). Limited to 2 GB (64 KB for Lotus Notes). Remark: If the message contains special characters, accents, use the constant emailOptionEncode when sending the message with the function EmailSendMessage.
MessageID	Character string	Unique email identifier. This identifier remains constant for the entire email lifetime. This identifier is used to follow a conversation. When sending an email, this variable specifies the email identifier. If this variable corresponds to an empty string, the identifier will be given by the server. The application that generates the identifier must check whether this identifier is unique. When receiving an email, this variable specifies the email identifier. This identifier must have the following format: <Identifier@domain>. For example: 1@192.168.2.210 This property is not supported in Lotus Notes. This property is supported by Outlook in Pocket. This property is not supported by Outlook in Windows.
Priority	Integer constant	Type of priority for the email. The possible values are as follows: emailLowPriority: used for the really non-urgent emails. emailHighPriority: used for the urgent emails. emailNormalPriority (Default value): used for the non-urgent emails.
Reference	Character string	Unique identifier of one or more reference emails linked to the current conversation. This property is not supported in Lotus Notes. This property is supported by Outlook in Pocket. This property is not supported by Outlook in Windows.
Versions 16 and later Signature New in version 16 Signature Signature	Integer constant	Status of email signature: certificateExpired: Valid signature but expired certificate. certificateInvalid: Invalid signature or certificate. certificateUntrusted: Valid signature but untrusted certificate root. certificateOK: Trusted signature and certificate. This property is available in read-only. Versions 16 and later This property is not available. New in version 16 This property is not available. This property is not available.
Source	Character string	Contains the source of incoming message (subject, sender, recipient, content, ...). This property is supported by Outlook in Pocket. This property is not supported by Outlook in Windows.
Subject	Character string	Message subject. Remark: If the subject contains special characters, accents, use the constant emailOptionEncode when sending the message with the function EmailSendMessage.
PlainText	Character string	Plain text of message. This variable is available for the incoming emails only.

• These properties can be used via one of the following syntaxes:
  • <Variable name>..<Property name>
  • <Variable name>.<Property name>
• Versions 17 and later
  You have the ability to use non-Latins characters in the following properties: ..Subject, ..Message, ..Category, ..SenderAddress, ..Sender, ..ID. In this case, use the constant emailOptionEncode when sending the message with the function EmailSendMessage.
  New in version 17
  You have the ability to use non-Latins characters in the following properties: ..Subject, ..Message, ..Category, ..SenderAddress, ..Sender, ..ID. In this case, use the constant emailOptionEncode when sending the message with the function EmailSendMessage.
  You have the ability to use non-Latins characters in the following properties: ..Subject, ..Message, ..Category, ..SenderAddress, ..Sender, ..ID. In this case, use the constant emailOptionEncode when sending the message with the function EmailSendMessage.

Correspondence between the properties and the RFC standard

WLanguage functions

Versions 12 and later EmailBuildSource New in version 12 EmailBuildSource EmailBuildSource	Generates the source code of outgoing email from the variables currently found in the email structure or in an Email variable].
Versions 15 and later EmailChangeStatus New in version 15 EmailChangeStatus EmailChangeStatus	Changes the status of an email on a messaging server.
Versions 17 and later EmailCopy New in version 17 EmailCopy EmailCopy	Copies an email found in a directory to another directory of an IMAP server.
Versions 09 and later EmailDeleteMessage New in version 09 EmailDeleteMessage EmailDeleteMessage	Used to delete the current email according to the current protocol (POP3, IMAP, MS Exchange, Pocket Outlook, Lotus Notes or Outlook messaging).
Versions 20 and later EmailGetIndicator New in version 20 EmailGetIndicator EmailGetIndicator	Retrieves the indicators defined on an email of IMAP session.
Versions 10 and later EmailImportHTML New in version 10 EmailImportHTML EmailImportHTML	Imports, into the Email structure or into an Email variable, the content of an HTML file in order to send it by email.
Versions 12 and later EmailImportSource New in version 12 EmailImportSource EmailImportSource	Fills an Email variable from the content of its ..Source property or the different variables of the email structure from the content of the Email.Source variable.
Versions 15 and later EmailLoadAttachment New in version 15 EmailLoadAttachment EmailLoadAttachment	Adds an attached file to an email.
Versions 09 and later EmailReadFirst New in version 09 EmailReadFirst EmailReadFirst	Reads the first incoming email according to the protocol used (POP3 or IMAP, MS Exchange, Lotus Notes or Outlook).
Versions 09 and later EmailReadFirstHeader New in version 09 EmailReadFirstHeader EmailReadFirstHeader	Reads the header of the first incoming email according to the protocol used (POP3 or IMAP, Lotus Notes or Outlook).
Versions 09 and later EmailReadLast New in version 09 EmailReadLast EmailReadLast	Reads the last incoming email according to the protocol used (POP3 or IMAP, MS Exchange, Lotus Notes or Outlook).
Versions 09 and later EmailReadLastHeader New in version 09 EmailReadLastHeader EmailReadLastHeader	Reads the header of last incoming email according to the protocol used (POP3 or IMAP, Lotus Notes or Outlook).
Versions 09 and later EmailReadMessage New in version 09 EmailReadMessage EmailReadMessage	Reads an incoming according to the protocol used (POP3 or IMAP, Lotus Notes or Outlook).
Versions 09 and later EmailReadMessageHeader New in version 09 EmailReadMessageHeader EmailReadMessageHeader	Reads the header of an incoming email according to the protocol used (POP3 or IMAP, Lotus Notes or Outlook).
Versions 09 and later EmailReadNext New in version 09 EmailReadNext EmailReadNext	Reads the incoming email found after the current email according to the protocol (POP3 or IMAP, MS Exchange, Lotus Notes or Outlook).
Versions 09 and later EmailReadNextHeader New in version 09 EmailReadNextHeader EmailReadNextHeader	Reads the header of the email found after the current email according to the protocol used (POP3 or IMAP, Lotus Notes or Outlook).
Versions 09 and later EmailReadPrevious New in version 09 EmailReadPrevious EmailReadPrevious	Reads the email found before the current email according to the protocol used (POP3 or IMAP, MS Exchange, Lotus Notes or Outlook).
Versions 09 and later EmailReadPreviousHeader New in version 09 EmailReadPreviousHeader EmailReadPreviousHeader	Reads the header of the email found before the current email according to the protocol used (POP3 or IMAP, Lotus Notes or Outlook).
Versions 09 and later EmailReset New in version 09 EmailReset EmailReset	Re-initializes all the variables of the email structure or all the variables of an Email variable.
Versions 11 and later EmailSeekFirst New in version 11 EmailSeekFirst EmailSeekFirst	Finds one or more emails according to the criteria specified in the messaging software (Outlook, messaging software using the IMAP protocol, ...).
Versions 11 and later EmailSeekFirstNotes New in version 11 EmailSeekFirstNotes EmailSeekFirstNotes	Seeks one or more emails according to specified criteria, in a local or remote Lotus Notes or Domino database.
Versions 09 and later EmailSendMessage New in version 09 EmailSendMessage EmailSendMessage	Sends an email according to the protocol used (SMTP, MS Exchange, Pocket Outlook, Lotus Notes, Outlook).