The PR_DISPLAY_NAME property contains the display name for a given MAPI object.
| Header file: | MAPITAGS.H |
| Must be exposed by: | Folder, messaging user, provider, and status objects |
| Identifier: | 0x3001 |
| Property type: | PT_TSTRING |
| Property tag: | 0x3001001E (0x3001001F for Unicode) |
| Corresponding X.400 attribute: | IM_FREE_FORM_NAME |
Folders require sibling subfolders to have unique display names. For example, if a folder contains two subfolders, the two subfolders cannot use the same value for their PR_DISPLAY_NAME properties. This restriction does not apply to other containers, such as address books and distribution lists.
PR_DISPLAY_NAME is one of the base address properties for all messaging users. For more information on the base address properties, see Base Address Properties.
Service providers should set the value of PR_DISPLAY_NAME so that it contains both the provider type and configuration information. The additional information helps to distinguish between instances of providers of the same type. Unconfigured providers should use a string that names the provider. Configured providers should use the same string followed by a distinguishing string in parentheses. For example, an unconfigured message store provider might set PR_DISPLAY_NAME to:
Personal Information Store
The configured version could then set PR_DISPLAY_NAME to:
Personal Information Store (September 17, 1997)
For status objects, the PR_DISPLAY_NAME property contains the name of the component that can be displayed by the user interface.
Note Semicolons cannot be used within recipient names in MAPI messaging.
Base Address Properties, PR_TRANSMITTABLE_DISPLAY_NAME