mailReadMessage PowerScript function

Description

Opens a mail message whose ID is stored in the mail session’s
message array. You can choose to read the entire message or the
envelope (sender, date received, and so on) only. If a message has
attachments, they are stored in a temporary file. You can also choose
to have the message text written to in a temporary file.

Controls

mailSession object

Syntax

<span>mailsession</span>.<span>mailReadMessage</span> ( <span>messageid</span>, <span>mailmessage</span>, <span>readoption</span>, <br>  <span>mark </span>)

1	<span>mailsession</span>.<span>mailReadMessage</span> ( <span>messageid</span>, <span>mailmessage</span>, <span>readoption</span>, <br> <span>mark </span>)

Argument	Description
mailsession	A mailSession object identifying the session in which you want to read a message.
messageid	A string whose value is the ID of the mail message you want to read.
mailmessage	A mailMessage structure in which mailReadMessage stores the message information.
readoption	A value of the mailReadOption enumerated datatype: mailEntireMessage! – Obtain header, text, and attachments mailEnvelopeOnly! – Obtain header information only mailBodyAsFile! – Obtain header, text, and attachments, and treat the message text as the first attachment, storing it in a temporary file mailSuppressAttachments! – Obtain header and text, but no attachments
mark	A boolean indicating whether you want to mark the message as read in the user’s inbox. Values are: TRUE – Mark the message as read FALSE – Do not mark the message as read

Return Values

MailReturnCode. Returns one of the following values:

mailReturnSuccess!
mailReturnFailure!
mailReturnInsufficientMemory!

If any argument’s value is null, mailReadMessage returns null.

Usage

To obtain the message IDs for the messages in the user’s
inbox, call mailGetMessages.

Before calling mail functions, you must declare and create
a mailSession object and call mailLogon to establish
a mail session.

Reading attachments

If a message has an attachment and you do not suppress attachments, information
about it is stored in the AttachmentFile property of the mailMessage
object. The AttachmentFile property is a mailFileDescription object.
Its PathName property has the location of the temporary file that mailReadMessage
created for the attachment. By default, the temporary file is in
the directory specified by the TEMP environment variable.

Be sure to delete this temporary file when you no longer need
it.

Examples

In this example, mail is displayed in a window with
a DataWindow dw_inbox that lists mail
messages and a MultiLineEdit mle_note that
displays the message text. Assuming that the application has created
the mailSession object mSes and successfully
logged on, and that dw_inbox contains
a list of mail items (sender, subject, postmark, and message ID);
this script for the Clicked event for dw_inbox displays
the text of the selected message in the MultiLineEdit mle_note:

integer nRow, nRet

1	integer nRow, nRet

string sMessageID

1	string sMessageID

string sRet, sName

1	string sRet, sName

// Find out what Mail Item was selected

1	// Find out what Mail Item was selected

nRow = GetClickedRow()

1	nRow = GetClickedRow()

IF nRow &gt; 0 THEN

1	IF nRow > 0 THEN

    // Get the message ID from the row

1	// Get the message ID from the row

    sMessageID = GetItemString(nRow, 'MessageID')

1	sMessageID = GetItemString(nRow, 'MessageID')

    // Reread the message to obtain entire contents

1	// Reread the message to obtain entire contents

    // because previously we read only the envelope

1	// because previously we read only the envelope

    mRet = mSes.<span>mailReadMessage</span>(sMessageID, mMsg &amp;

1	mRet = mSes.<span>mailReadMessage</span>(sMessageID, mMsg &

    mailEntireMessage!, TRUE)

1	mailEntireMessage!, TRUE)

    // Display the text

1	// Display the text

    mle_note.Text = mMsg.NoteText

1	mle_note.Text = mMsg.NoteText

END IF

END IF

See mailGetMessages for an example that
creates a list of mail messages in a DataWindow control, the type
of setup that this example expects. See also the mail examples in
the Code Examples sample application supplied with PowerBuilder.

Connection Information

mailReadMessage – PB Docs 126