IMAPISupport::CompareEntryIDs
Gilt für: Outlook 2013 | Outlook 2016
Vergleicht zwei Eintragsbezeichner, um zu bestimmen, ob sie auf dasselbe Objekt verweisen.
HRESULT CompareEntryIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
Parameter
cbEntryID1
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEntryID1-Parameter verweist.
lpEntryID1
[in] Ein Zeiger auf den ersten zu vergleichenden Eintragsbezeichner.
cbEntryID2
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEntryID2-Parameter verweist.
lpEntryID2
[in] Ein Zeiger auf den zweiten zu vergleichenden Eintragsbezeichner.
ulFlags
[in] Reserviert. NULL muss sein.
lpulResult
[out] Ein Zeiger auf das Ergebnis des Vergleichs. TRUE, wenn die beiden Eintragsbezeichner auf dasselbe Objekt verweisen; andernfalls FALSE.
Rückgabewert
S_OK
Der Vergleich war erfolgreich.
MAPI_E_UNKNOWN_ENTRYID
Ein oder beide der als Parameter angegebenen Eintragsbezeichner verweisen nicht auf gültige Objekte, möglicherweise weil sie derzeit nicht geöffnet und nicht verfügbar sind.
Hinweise
Die IMAPISupport::CompareEntryIDs-Methode wird für Adressbuch- und Nachrichtenspeicheranbieter-Unterstützungsobjekte implementiert. CompareEntryIDs vergleicht zwei Eintragsbezeichner, die zu einem einzelnen Dienstanbieter gehören, um zu bestimmen, ob sie auf dasselbe Objekt verweisen. MAPI extrahiert den MAPIUID-Teil aus den Eintragsbezeichnern, um den für die Objekte verantwortlichen Dienstanbieter zu bestimmen. MAPI ruft dann die CompareEntryIDs-Methode ihres Anmeldeobjekts auf, um den Vergleich durchzuführen.
Hinweise für Aufrufer
CompareEntryIDs ist nützlich, da ein Objekt mehr als einen gültigen Eintragsbezeichner aufweisen kann. Diese Situation kann beispielsweise auftreten, nachdem eine neue Version eines Dienstanbieters installiert wurde.
Wenn CompareEntryIDs einen Fehler zurückgibt, führen Sie keine Aktion basierend auf dem Ergebnis des Vergleichs aus. Wählen Sie stattdessen den möglichst konservativen Ansatz aus. CompareEntryIDs können fehlschlagen, wenn z. B. einer oder beide der Eintragsbezeichner eine ungültige MAPIUID-Struktur enthalten.