|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.|
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.
Compares two entry identifiers to determine whether they refer to the same object.
The IMAPISupport::CompareEntryIDs method is implemented for address book and message store provider support objects. CompareEntryIDs compares two entry identifiers that belong to a single service provider to determine whether they refer to the same object. MAPI extracts the MAPIUID portion from the entry identifiers to determine the service provider responsible for the objects. MAPI then calls its logon object's CompareEntryIDs method to perform the comparison.
CompareEntryIDs is useful because an object can have more than one valid entry identifier. This situation can occur, for example, after a new version of a service provider is installed.
If CompareEntryIDs returns an error, do not take any action based on the result of the comparison. Instead, take the most conservative approach possible. CompareEntryIDs might fail if, for example, one or both of the entry identifiers contain an invalid MAPIUID structure.