MailOutBoxGetStatusReport

function

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

Declaration
define external function MailOutBoxGetStatusReport
        value MailOutBox this-MailOutBox
   into write-only string report

Argument definitions

this-MailOutBox
is an OMX component of type MailOutBox.
report
is the string shelf in which the error messages are stored.


Purpose

If the MailOutBox is not in error, this function clears the report shelf; if the MailOutBox is in error, the function populates the report shelf with one or more error messages (each as an item on the shelf).

MailInBoxGetStatusReport can be called at any time, but will return an empty report shelf if there is no error.

Example:


  MailOutBoxGetStatusReport MyBox into report
  repeat over report
     put #error report
  again