PR_MAPPING_SIGNATURE

The PR_MAPPING_SIGNATURE property contains the mapping signature for named properties of a particular MAPI object.

Quick Info

Header file: MAPITAGS.H
May be exposed by: Objects having named properties
Identifier: 0x0FF8
Property type: PT_BINARY
Property tag: 0x0FF80102

Remarks

It is recommended that objects having named properties expose the PR_MAPPING_SIGNATURE 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 PR_MAPPING_SIGNATURE 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 Named Properties.

See Also

General Object Properties, MAPINAMEID