IMAPISession::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 Objekte, möglicherweise weil diese Objekte derzeit ungeöffnet und nicht verfügbar sind.
Hinweise
Die IMAPISession::CompareEntryIDs-Methode 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, und ruft dann die CompareEntryIDs-Methode des Anmeldeobjekts auf, um den Vergleich durchzuführen.
Hinweise für Aufrufer
Die CompareEntryIDs-Methode 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 enthalten.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| BaseDialog.cpp |
CbaseDialog::OnCompareEntryIDs |
MFCMAPI verwendet die IMAPISession::CompareEntryIDs-Methode , um zwei Eintrags-IDs zu vergleichen, die ein Benutzer eingibt. |