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
PR_ATTACH_DATA_OBJ