PR_SEND_RICH_INFO

The PR_SEND_RICH_INFO property contains TRUE if the recipient can receive all message content, including Rich Text Format and OLE objects.

Quick Info

Header file: MAPITAGS.H
May be exposed by: Distribution list and messaging user objects
Identifier: 0x3A40
Property type: PT_BOOLEAN
Property tag: 0x3A40000B

Remarks

It is recommended that distribution list and messaging user objects expose the PR_SEND_RICH_INFO property.

PR_SEND_RICH_INFO indicates whether the sender considers the recipient to be MAPI-enabled.

When this property is set to TRUE, the transport and gateway can transmit the full content of the message, including Rich Text Format and OLE objects. The transport provider and gateway should use TNEF to encapsulate any properties that are not native to all the messaging systems involved.

When this property is set to FALSE, the transport provider and gateway are free to discard message content that their native clients cannot use. For example, when the clients do not support Rich Text Format, the transport provider can send only plain text.

When PR_SEND_RICH_INFO is not set, default behavior is determined by the implementation of the transport provider, MTA, or gateway. Address book providers are not required to support this property. For example, a tightly coupled address book and transport provider can choose to send TNEF but never use Rich Text Format.

The client should not assume the transport provider and gateway will use TNEF on their own initiative. Some transport providers and gateways that support TNEF transmit it without regard to the value of PR_SEND_RICH_INFO, but others decline to construct or send TNEF if PR_SEND_RICH_INFO is not set to TRUE.

Note The setting of this property, and the decisions based on its value, are on a per-recipient basis.

By default, MAPI sets the value of PR_SEND_RICH_INFO to TRUE. A client calling IAddrBook::CreateOneOff or a provider calling IMAPISupport::CreateOneOff can set the MAPI_SEND_NO_RICH_INFO bit in the ulFlags parameter, which causes MAPI to set PR_SEND_RICH_INFO to FALSE. One-offs created by the user interface use the value specified by the creating template.

On calls to the IAddrBook::ResolveName method when the name cannot be resolved but can be interpreted as an Internet address (SMTP), PR_SEND_RICH_INFO is set to FALSE. To be construed as an Internet address, the display name of the unresolved entry must be in the format X@Y.Z, such as "pete@pinecone.com".

See Also

Rich Text Properties, PR_ATTACH_DATA_OBJ