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 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.

Siehe auch

IAddrBook : IMAPIProp