Page History
...
Parameter | Description |
---|---|
session | Contains a MAPI session handle returned by MAPILogon. |
Parent | Contains the name of an OpenInsight parent window. If not specified any dialog box displayed will be application modal. |
Id | Contains the id of the message which is to be read. Message ids are returned by MAPIOpenMail and MAPISaveMail. |
flags | Contains information about how the message should be read. It could be MAPI_ENVELOPE_ONLY$, MAPI_SUPPRESS_ATTACH$, MAPI_BODY_AS_FILE$, MAPI_PEEK$, or a combination of these flags.
The insert record MAPI_EQUATES contains these flags. You may combine flags by adding them together with an addition sign (+). |
message | On output contains the message record which has been read. The message record structure is detailed in the following table. |
After the function completes successfully the message parameter will contain the information read from the specified message including a list of paths to any temporary copies of file attachments. When the application is through processing the file attachments it is responsible for deleting the temporary copies with calls to the OSDelete function.
Use the MAPI_EQUATES insert record for access to the values in the following table.
Column position | Name | Purpose |
---|---|---|
1 | subject | The subject of the message. |
2 | from | The sender of the message. |
3 | to | @VM-delimited list of the message's To: recipients. |
4 | cc | @VM-delimited list of the message's CC: recipients. |
5 | bcc | @VM-delimited list of the message's BCC: recipients. |
6 | date | The date the message was received. |
7 | text | The text of the message. |
8 | type | The type of the message. |
9 | flags | The attributes of the message. It could be MAPI_UNREAD$, MAPI_RECEIPT_REQUESTED$, MAPI_SENT$, or a combination of these flags.
The insert record MAPI_EQUATES contains these flags. |
10 | files | @VM-delimited list of the names of files attached to the message. |
11 | paths | @VM-delimited list of the paths to temporary copies of files attached to the message. |
12 | positions | @VM-delimited list of the positions within the text of files attached to the message. |
...