Share via

Working with MAPI Messages and Folders

  • Article

Working with MAPI Messages and Folders

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release. A message always has an associated recipient table, and can also have attachments and embedded messages. Embedded messages have their own PR_MESSAGE_CLASS and PR_SUBJECT properties, as well as their own recipient tables. The recipient table contains the following MAPI properties for each recipient of the message.

Property Name Description
PR_ADDRTYPE Type of address. For example, SMTP.
PR_DISPLAY_NAME Display name of the recipient. For example, Jonathan Mollerup.
PR_EMAIL_ADDRESS E-mail address of the recipient, in the format indicated by PR_ADDRTYPE. For example, jonmo@microsoft.com.
PR_ENTRYID Entry identifier (ID) with the Microsoft® Exchange Server address book for a recipient.
PR_RECIPIENT_TYPE Recipient type, MAPI_TO.
PR_SEND_RICH_INFO Recipient is a MAPI recipient.

Note  A gateway must always check the recipient table of the embedded MAPI message to find the correct value for the PR_SEND_RICH_INFO property. A message sent to a one-off address through a gateway does not carry this property in its message transfer envelope (MTE).

MAPI Folders use the IMAPIFolder interface. The IMAPIFolder interface exposes methods to access a table of messages contained in the folder, and to manipulate the contents of that table and its messages.

Note  Gateways are a special kind of client application. Therefore, not all of the information about this subject in the MAPI Programmer's Reference Online link is directly applicable to gateways.

The following topics discuss working with MAPI messages and folders:

Accessing Messages in the MTS-IN and MTS-OUT Folders

Using MAPI Folders

Limiting Unread Messages in the Gateway

For more information, see the MAPI Programmer's Reference Online link.

Send us your feedback about the Microsoft Exchange Server 2003 SDK.

Build: June 2007 (2007.618.1)

© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.