Published: July 16, 2012
Compares two message store entry identifiers to determine whether they refer to the same store object.
MAPI calls the IMSProvider::CompareStoreIDs method when it processes a call to the IMAPISession::OpenMsgStore method. CompareStoreIDs is called at this point to determine which profile section, if any, is associated with the message store being opened. A CompareStoreIDs call can be made when no message stores are open for a particular store provider. In addition, MAPI also calls CompareStoreIDs when it processes a store provider call to the IMAPISupport::OpenProfileSection method.
The entry identifiers compared by CompareStoreIDs are both for the current store provider's dynamic-link library (DLL) and are both unwrapped store entry identifiers. For more information about wrapping store entry identifiers, see IMAPISupport::WrapStoreEntryID.
Comparing entry identifiers is useful because an object can have more than one valid entry identifier. This can occur, for example, after a new version of a message store provider is installed.