PidTagBody Canonical Property

Applies to: Outlook 2013 | Outlook 2016

Contains the message text.

Associated properties:
PR_BODY, PR_BODY_A, PR_BODY_W
Identifier:
0x1000
Data type:
PT_UNICODE, PT_STRING8
Area:
General messaging

Remarks

These properties are typically used only in an interpersonal message (IPM).

Message stores that support Rich Text Format (RTF) ignore any changes to white space in the message text. When PR_BODY is stored for the first time, the message store also generates and stores the PR_RTF_COMPRESSED (PidTagRtfCompressed) property, the RTF version of the message text. If the IMAPIProp::SaveChanges method is subsequently called and PR_BODY has been modified, the message store calls the RTFSync function to ensure synchronization with the RTF version. If only white space has been changed, the properties are left unchanged. This preserves any nontrivial RTF formatting when the message travels through non-RTF-aware clients and messaging systems.

The value for this property must be expressed in the code page of the operating system that MAPI is running on.

Protocol specifications

[MS-OXPROPS]

Provides references to related Exchange Server protocol specifications.

[MS-OXCMSG]

Handles message and attachment objects.

Header files

Mapidefs.h

Provides data type definitions.

Mapitags.h

Contains definitions of properties listed as alternate names.

See also

PidTagRtfInSync Canonical Property

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names