PR_DISPLAY_NAME
The
PR_DISPLAY_NAME property contains the display name for a given MAPI object.
Quick Info
|
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 |
Remarks
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, while the configured version could set
PR_DISPLAY_NAME to Personal Information Store (July 31, 1996).
For status
objects, this 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.
See Also
PR_TRANSMITTABLE_DISPLAY_NAME