Platform SDK: MAPI |
A long-term entry identifier is assigned by a service provider to an object when an object requires an identifier with a prolonged lifespan. Long-term entry identifiers are always valid for weeks or months and can be valid on other workstations, depending on the provider. The long-term identifiers created by address book providers for custom recipients are universally valid.
Long-term entry identifiers are assigned to message stores, folders, messages, address book containers, messaging users, and distribution lists. When client applications call the IMAPIProp::GetProps method of these objects, it is always a long-term entry identifier that is returned.
Because long-term entry identifiers must be unique across all message stores in the active profile, when a message or folder is copied from one message store to another, it must be assigned a new entry identifier. However, when a message store object is moved, whether or not the original entry identifier remains valid is up to the message store provider implementing the move. Some service providers assign new entry identifiers to moved objects; others do not. If there is a change, the new entry identifier will be included in the information passed to clients when they are notified of the move.
Typically, message store providers implement the following behavior when moving folders:
Note Renaming a folder without changing its parent usually does not cause the entry identifier to change.