Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Outlook 2013 | Outlook 2016
Vergleicht zwei Eintragsbezeichner, die zu einem bestimmten Adressbuchanbieter gehören, um zu bestimmen, ob sie auf dasselbe Adressbuchobjekt verweisen.
HRESULT CompareEntryIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
Parameter
cbEntryID1
[in] Die Byteanzahl im Eintragsbezeichner, auf den der lpEntryID1-Parameter zeigt.
lpEntryID1
[in] Ein Zeiger auf den ersten eEintragsbezeichner, der verglichen werden soll.
cbEntryID2
[in] Die Byteanzahl im Eintragsbezeichner, auf den der lpEntryID2-Parameter zeigt.
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. Der Inhalt von lpulResult wird auf WAHR festgelegt, wenn die beiden Eintragsbezeichner auf dasselbe Objekt verweisen. Andernfalls wird der Inhalt auf FALSCH festgelegt.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.
MAPI_E_UNKNOWN_ENTRYID
Mindestens einer der Eintragsbezeichner, die mit den Parametern lpEntryID1 oder lpEntryID2 übergeben werden, wird von keinem Adressbuchanbieter erkannt.
Hinweise
Clientanwendungen und Dienstanbieter rufen die CompareEntryIDs-Methode auf, um zwei Eintragsbezeichner zu vergleichen, die zu einem einzelnen Adressbuchanbieter gehören, um zu bestimmen, ob sie auf dasselbe Objekt verweisen. CompareEntryIDs ist nützlich, da ein Objekt mehrere gültige Eintragsbezeichner haben kann. Diese Situation kann beispielsweise auftreten, nachdem eine neue Version eines Adressbuchanbieters installiert wurde.
MAPI übergibt diesen Aufruf an den Adressbuchanbieter, der für die Eintragsbezeichner verantwortlich ist. Dabei wird der entsprechende Anbieter bestimmt, indem die MAPIUID-Struktur in den Eintragsbezeichnern mit der MAPIUID-Struktur übereinstimmt, die vom Anbieter registriert wurde.
Wenn die beiden Eintragsbezeichner auf dasselbe Objekt verweisen, legt CompareEntryIDs den Inhalt des Parameters lpulResult auf WAHR fest. Wenn sie auf verschiedene Objekte verweisen, legt CompareEntryIDs den Inhalt auf FALSCH fest. In beiden Fällen gibt CompareEntryIDs S_OK zurück. Wenn CompareEntryIDs einen Fehler zurückgibt, der auftreten kann, wenn kein Adressbuchanbieter eine MAPIUID-Struktur registriert hat, die mit der Struktur in den Eintragsbezeichnern übereinstimmt, sollten Clients und Anbieter basierend auf dem Ergebnis des Vergleichs keine Maßnahmen ergreifen. Stattdessen sollten sie den effizientesten Ansatz für die ausgeführte Aktion verfolgen.