Sfairadora

  • Reference Guide

send_mail

send_mail(subject, text, addr, open)
send_mail(subject, text, addr, attachments, open)
The function sends an e-mail. The standard e-mail client application registered within the operating system is used to accomplish the task (e.g. Outlook Express or other).

Parameters

subject
The text used as the subject of the e-mail (the type String).
text
The contents of the e-mail (the type Text).
addr
The list of the e-mail addressees. If only one address is specified, it suffices to specify the address as a String. If more than one address is to be specified, they are passed as a sequence of strings (the type String[*]).
attachments
A list of attachments to the e-mail. The attachments are specified as a list of strings. Every item in the list is a full path to a file to be attached to the e-mail. The type of the parameter is String[*].
open
A parameter of the type Bool. If the parameter is set to TRUE, the e-mail created is opened in an e-mail client window, as if the e-mail were written by the user. The user has then an opportunity to edit the e-mail. It depends on the user’s decision, whether the e-mail is really sent. There is no way for Sfairadora to find out that the e-mail was canceled. If the parameter is set to FALSE, the e-mail is sent immediately. If, however, the e-mail client is configured to store e-mails to a folder for e-mails intended to be sent, instead of direct sending them, the e-mail created will be just stored to that folder. It will actually be send at the next e-mail synchronization. Note: newer versions of Outlook Express ask the user whether to send the e-mail, even though the direct sending was requested.

Return Value

The function returns the value NONE. If the e-mail could not be sent, an error is returned.