Other Library Functions

Library: ommail - email support (SMTP and POP3) Include: ommail.xin

Declaration

  define external output function MailOutBoxSendMail
             value MailOutBox this-MailOutBox
     to      value stream recipient
     subject value stream subject optional initial {""}
     header  value stream header-info optional

This function sends a mail message with the specified subject, mail header, and recipient. It returns an external output object which is used to send the body of the message. As you write to the stream, the message parts are sent out (there is no buffering of the message). Closing the stream attached to this external output object signals the end of message composition and triggers the completion of the delivery of the message. It is an error to reopen a stream attached to an external output object derived from a mail outbox object, once that stream has been closed.

Arguments:

• "this-MailOutBox" is an opaque-type object of type MailOutBox.
• "recipient" is the email address to which the message is being sent.
• "subject" is an optional subject field.
• "header" is where you can optionally specify header information, according to the mail-header protocol.

Example: