PidTagDisplayTo Canonical Property

Last modified: January 16, 2009

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains a list of the display names of the primary (To) message recipients, separated by semicolons (;).

Associated properties:




Data type:




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 the IMAPIProp::SaveChanges method.

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

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 (PidTagDisplayCc), and PR_DISPLAY_TO properties. Semicolons are not permitted within recipient names in MAPI.

  • Clients should translate each semicolon encountered in the PR_DISPLAY_TO and related properties to a localized separator character before making the information visible in the user interface.

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

Protocol Specifications


Specifies the properties and operations that are permissible for e-mail message objects.

Header Files


Provides data type definitions.


Contains definitions of properties listed as alternate names.