PidTagSendRichInfo Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains TRUE if the recipient can receive all message content, including Rich Text Format (RTF) and Object Linking and Embedding (OLE) objects.

Associated properties:

PR_SEND_RICH_INFO

Identifier:

0x3A40

Data type:

PT_BOOLEAN

Area:

Address

Remarks

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

This property 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 RTF and OLE objects. The transport provider and gateway should use Transport Neutral Encapsulation Format (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 RTF, the transport provider can send only plain text.

When this property is not set, default behavior is determined by the implementation of the transport provider, message transfer agent (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 RTF.

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 this property, but others decline to construct or send TNEF if it 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 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 this property 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), this property 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".

Protocol Specifications

  • [MS-OXPROPS]
    Provides references to related Exchange Server protocol specifications.

  • [MS-OXOABK]
    Specifies the properties and operations for lists of users, contacts, groups, and resources.

  • [MS-OXOMSG]
    Specifies the properties and operations that are permissible for e-mail message objects.

  • [MS-OXCMAIL]
    from Internet standard e-mail conventions to message objects.

Header Files

  • Mapidefs.h
    Provides data type definitions.

  • Mapitags.h
    Contains definitions of properties listed as associated properties.

See Also

Reference

PidTagAttachDataObject Canonical Property

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names