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
MAPINAMEID