Share via


PidTagMappingSignature 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 mapping signature for named properties of a particular MAPI object.

Associated properties:

PR_MAPPING_SIGNATURE

Identifier:

0x0FF8

Data type:

PT_BINARY

Area:

Miscellaneous

Remarks

It is recommended that objects having named properties expose this property. A client application should check the PR_MAPPING_SIGNATURE property of both objects when copying named properties from one object to another. Use of this property can minimize translating between copied properties' names and identifiers.

If this property does not exist for a given MAPI object, then the object has its own unique mapping of names and identifiers. In this case the client must call the IMAPIProp::GetNamesFromIDs method on the source object and then the IMAPIProp::GetIDsFromNames method on the destination object.

When two objects have the same PR_MAPPING_SIGNATURE value, the client does not need to translate name to identifier and identifier to name. The client can simply call the IMAPIProp::GetProps method on the source and then the IMAPIProp::SetProps method on the destination. This is convenient for clients that perform custom copying of named properties, and for providers implementing the IMAPIProp::CopyTo and IMAPIProp::CopyProps methods.

For more information on named properties and mapping of names and identifiers, see MAPI Named Properties.

Protocol Specifications

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

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

Header Files

  • Mapidefs.h
    Provides data type definitions.

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

See Also

Reference

MAPINAMEID

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names