Platform SDK: MAPI

Mapping of Internet Mail Attributes to MAPI Properties

This appendix describes how a MAPI transport provider or MAPI-aware gateway which connects to the Internet should translate between MAPI message properties and Simple Mail Transport Protocol (SMTP) message attributes. SMTP is the messaging protocol used on much of the Internet. SMTP defines a set of message headers — the message envelope — and a message content format. SMTP is fully documented in a set of two docments, RFC 821 and RFC 822, which can be found at a number of FTP and WWW sites on the Internet.

For information on the SMTP protocol used to communicate with SMTP-based mail agents, see RFC 821.

For addressing and standard message headers, see RFC 822.

For MIME, see RFC 1521.

The goal of mapping SMTP message attributes to MAPI properties (and vice versa) is to ensure that the full content of MAPI messages, over and above that which can be encoded using native SMTP message attributes, can be reliably exchanged among different MAPI components that must communicate over the Internet. This document is based on work already done on such components at Microsoft. How to translate between MAPI message properties and X.400 message attributes is described in the appendix, Mapping of X.400 P2 Attributes to MAPI Properties.

This document assumes familiarity with MAPI transports, TNEF, and SMTP mail. It strives to be concise rather than abundantly clear.

As a convention, "outbound" refers to mail traveling from a MAPI-compliant UA or MTA to the Internet, and "inbound" refers to mail traveling from the Internet to a MAPI component.