PidTagDisplayName Canonical Property

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Contains the display name for a given MAPI object.

Associated properties:	PR_DISPLAY_NAME, PR_DISPLAY_NAME_A, PR_DISPLAY_NAME_W
Identifier:	0x3001
Data type:	PT_STRING8, PT_UNICODE
Area:	MAPI common

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 this property. This restriction does not apply to other containers, such as address books and distribution lists.

Service providers should set the value of this property 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 these properties to:

Personal Information Store

The configured version could then set these properties to:

Personal Information Store (February 6, 1998)

For status objects, these properties contain the name of the component that can be displayed by the user interface.

Note
Semicolons cannot be used within recipient names in MAPI messaging.

Related Resources

Protocol Specifications

• [MS-OXPROPS]
  Provides references to related Exchange Server protocol specifications.

• [MS-OXCMSG]
  Handles message and attachment objects.

• [MS-OXCFOLD]
  Handles folder operations.

• [MS-OXOCNTC]
  Specifies the properties and operations that are permissible for contacts and personal distribution lists.

• [MS-OXOABK]
  Specifies the properties and operations for lists of users, contacts, groups, and resources.

• [MS-OXCMAIL]
  Converts from Internet standard e-mail conventions to message objects.

• [MS-XWDVSEC]
  Extends the WebDAV protocol that specifies how to request and set the Exchange security descriptor via WebDAV methods.

Header Files

• Mapidefs.h
  Provides data type definitions.

• Mapitags.h
  Contains definitions of properties listed as alternate names.

See Also

Reference

PidTagTransmittableDisplayName Canonical Property

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names