PR_DISPLAY_TO

The PR_DISPLAY_TO property contains an ASCII list of the display names of the primary (To) message recipients, separated by semicolons (;).

Quick Info

Remarks

The message store computes the PR_DISPLAY_TO property on message objects using the IMessage::ModifyRecipients method. The message store also maintains the property 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, PR_DISPLAY_CC, 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 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 primary recipient line.

See Also

Recipient List Properties