IMsgStore::CompareEntryIDs

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Vergleicht zwei Eintragsbezeichner, um zu bestimmen, ob sie auf denselben Eintrag in einem Nachrichtenspeicher verweisen. MAPI übergibt diesen Aufruf nur dann an einen Dienstanbieter, wenn die eindeutigen Bezeichner (UIDs) in beiden zu vergleichenden Eingabebezeichnern von diesem Anbieter verarbeitet werden.

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 Objekte, möglicherweise weil die entsprechenden Objekte derzeit ungeöffnet und nicht verfügbar sind.

Hinweise

Die IMsgStore::CompareEntryIDs-Methode vergleicht zwei Eintragsbezeichner, die zum Nachrichtenspeicher gehören, um zu bestimmen, ob sie auf dasselbe Objekt verweisen.

Hinweise für Aufrufer

CompareEntryIDs ist nützlich, da ein Objekt mehr als einen gültigen Eintragsbezeichner aufweisen kann (z. B. nachdem eine neue Version eines Nachrichtenspeicheranbieters 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 enthalten.