IAddrBook::CompareEntryIDs
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 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. Der Inhalt von lpulResult wird auf TRUE festgelegt, wenn die beiden Eintragsbezeichner auf dasselbe Objekt verweisen. Andernfalls wird der Inhalt auf FALSE festgelegt.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_UNKNOWN_ENTRYID
Mindestens ein eintragsbezeichner, der mit den Parametern lpEntryID1 oder lpEntryID2 übergeben wird, 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 festzustellen, ob sie auf dasselbe Objekt verweisen. 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 Adressbuchanbieters installiert wurde.
MAPI übergibt diesen Aufruf an den Adressbuchanbieter, der für die Eintrags-IDs verantwortlich ist, und bestimmt den entsprechenden Anbieter, indem die MAPIUID-Struktur in den Eintragsbezeichnern mit der vom Anbieter registrierten MAPIUID-Struktur übereinstimmt.
Wenn die beiden Eintragsbezeichner auf dasselbe Objekt verweisen, legt CompareEntryIDs den Inhalt des lpulResult-Parameters auf TRUE fest. Wenn sie auf verschiedene Objekte verweisen, legt CompareEntryIDs den Inhalt auf FALSE 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 der Struktur in den Eintragsbezeichnern entspricht, sollten Clients und Anbieter keine Aktion basierend auf dem Ergebnis des Vergleichs ausführen. Sie sollten stattdessen den konservativsten Ansatz für die ausgeführte Aktion verfolgen.