MailInBoxGetMessage

function

Library: Email support, SMTP and POP3 (OMMAIL)
Include: ommail.xin

Returns: an external source object


Declaration
define external string source function MailInBoxGetMessage
          value MailInBox this-MailInBox
 message value integer message

Argument definitions

this-MailInBox
is an OMX component of type MailInBox.
message
is the identification number for the message you wish to retrieve.


Purpose

This function returns an external source for reading a message identified by number.

Note that during the lifetime of the source, it is a fatal error to try to pass the MailInBox object to any library calls other than:

The MailInBoxClose causes the source to be terminated. This does not prohibit you from creating another MailInBox and doing what you wish with it, although many server implementations will not permit multiple connections to the same mailbox.

Example:


  set this-msg to MailInBoxGetMessage MyBox message 1