PidTagDisplayCc Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains an ASCII list of the display names of any carbon copy (CC) message recipients, separated by semicolons (;).

Associated properties:

PR_DISPLAY_CC, PR_DISPLAY_CC_A, PR_DISPLAY_CC_W

Identifier:

0x0E03

Data type:

PT_STRING8, PT_UNICODE

Area:

Message

Remarks

The message store computes these properties on message objects by using the IMessage::ModifyRecipients method. The message store also maintains these properties so that it always reflects the last saved state of a message. The value is synchronized at the time of every call to IMAPIProp::SaveChanges.

If a message has no carbon copy recipients, the message store should respond to an IMAPIProp::GetProps call with a return value of S_OK and an empty string for these properties.

Because of the possible need for localization, MAPI provides these guidelines for all recipient names:

  • All names should be able to be localized.

  • The semicolon should be the character that is used to separate names in the PR_DISPLAY_BCC (PidTagDisplayBcc), PR_DISPLAY_CC, and PR_DISPLAY_TO (PidTagDisplayTo) properties. Semicolons are not permitted within recipient names in MAPI.

  • Clients should translate each semicolon encountered in this property to a localized separator character before making the property information visible in the user interface.

  • When forwarding messages, clients do not need to translate the separator characters on the carbon copy recipient line.

Protocol Specifications

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