PidTagSubjectPrefix Canonical Property

  • Article

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains a subject prefix that typically indicates some action on a message, such as "FW: " for forwarding.

Associated properties:

PR_SUBJECT_PREFIX, PR_SUBJECT_PREFIX_A, PR_SUBJECT_PREFIX_W

Identifier:

0x003D

Data type:

PT_STRING8, PT_UNICODE

Area:

General messaging

Remarks

These properties are recommended on all message objects.

The subject prefix consists of one or more alphanumeric characters, followed by a colon and a space (which are part of the prefix). It must not contain any nonalphanumeric characters before the colon. Absence of a prefix can be represented by an empty string or by this property not being set.

If these properties are set explicitly, the string can be of any length and use any alphanumeric characters, but it must match a substring at the beginning of the PR_SUBJECT (PidTagSubject) property. If these properties are not set by the sender and must be computed, their contents are more restricted. The rule for computing the prefix is that PR_SUBJECT must begin with one, two, or three letters (alphabetic only) followed by a colon and a space. If such a substring is found at the beginning of PR_SUBJECT, it then becomes the string for these properties (and also stays at the beginning of PR_SUBJECT). Otherwise, these properties remain unset.

These properties and PR_NORMALIZED_SUBJECT (PidTagNormalizedSubject) should be computed as part of the IMAPIProp::SaveChanges implementation. A client should not prompt IMAPIProp::GetProps for their values until they have been committed by an IMAPIProp::SaveChanges call.

The subject properties are typically small strings of fewer than 256 characters, and a message store provider is not obligated to support the OLE IStream interface on them. A client should always attempt access through the IMAPIProp interface first, and resort to IStream only if MAPI_E_NOT_ENOUGH_MEMORY is returned.

Protocol Specifications

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

  • [MS-OXCMSG]
    Handles message and attachment objects.

  • [MS-OXOMSG]
    Specifies the properties and operations that are permissible on e-mail message 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