PidTagRenderingPosition Canonical Property

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Contains an offset, in characters, to use in rendering an attachment within the main message text.

Associated properties:

PR_RENDERING_POSITION

Identifier:

0x370B

Data type:

PT_LONG

Area:

MAPI attachment

Remarks

When the supplied offset is -1 (0xFFFFFFFF), the attachment is not rendered by using this property. All values other than -1 indicate the position within the PR_BODY (PidTagBody) property at which the attachment is to be rendered.

Note  The character indicated by this property in PR_BODY is replaced by the attachment. Typically this character is a space, although a special placeholder character can also be used.

This property is expressed in characters. In some character sets this is not equivalent to bytes. Unicode applications can compute the position based on two-byte characters. Double-Byte Character Set (DBCS) applications must scan the text up to this property value, because their character representation varies between one and two bytes per character.

This property should not be used with Rich Text Format (RTF) text. The rendering position is indicated in RTF by an escape sequence called the object attachment placeholder. This sequence consists of the string \objattph followed by a single character, normally a space, that will be replaced by the attachment rendering.

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

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names