Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IMAPISession::CompareEntryIDs

Windows Mobile 6.5
4/8/2010

The CompareEntryIDs method compares two entry identifiers to determine whether they refer to the same object.


HRESULT CompareEntryIDs (
  ULONG cbEntryID1,
  LPENTRYID lpEntryID1,
  ULONG cbEntryID2,
  LPENTRYID lpEntryID2,
  ULONG ulFlags,
  ULONG FAR * lpulResult
);

cbEntryID1

[in] Count of bytes in the entry identifier pointed to by lpEntryID1.

lpEntryID1

[in] Reference to the first entry identifier to be compared; cannot be NULL.

cbEntryID2

[in] Count of bytes in the entry identifier pointed to by lpEntryID2.

lpEntryID2

[in] Reference to the second entry identifier to be compared; cannot be NULL.

ulFlags

[in] Ignored.

lpulResult

[out] Reference to the result of the comparison, which is TRUE if the two entry identifiers refer to the same object and FALSE otherwise.

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

Indicates success.

MAPI_E_UNKNOWN_ENTRYID

One or both of the entry identifiers specified as parameters do not refer to objects, possibly because these objects are unopened and inaccessible at present.

CompareEntryIDs compares two entry identifiers belonging 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 and 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; for example, this might occur 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. For example, CompareEntryIDs might fail if one or both of the entry identifiers contain a nonvalid IsEqualMAPIUID.

Headermapix.h
Librarycemapi.lib
Windows Embedded CEWindows CE 3.0 and later
Windows MobilePocket PC 2002 and later, Smartphone 2002 and later

Reference

IMAPISession

Other Resources

Messaging

Community Additions

Show:
© 2015 Microsoft