IMSProvider::CompareStoreIDs
Gilt für: Outlook 2013 | Outlook 2016
Vergleicht zwei Nachrichtenspeichereintragsbezeichner, um zu bestimmen, ob sie auf dasselbe Speicherobjekt verweisen.
HRESULT CompareStoreIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
Parameter
cbEntryID1
[in] Die Größe des Eintragsbezeichners in Bytes, auf die der lpEntryID1-Parameter verweist .
lpEntryID1
[in] Ein Zeiger auf den ersten zu vergleichenden Eintragsbezeichner.
cbEntryID2
[in] Die Größe des Eintragsbezeichners in Bytes, 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 zurückgegebene Ergebnis des Vergleichs. TRUE, wenn die beiden Eintragsbezeichner auf dasselbe Objekt verweisen; andernfalls FALSE.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
Hinweise
MAPI ruft die IMSProvider::CompareStoreIDs-Methode auf, wenn sie einen Aufruf der IMAPISession::OpenMsgStore-Methode verarbeitet. An diesem Punkt wird CompareStoreIDs aufgerufen, um zu bestimmen, welcher Profilabschnitt dem geöffneten Nachrichtenspeicher zugeordnet ist, falls vorhanden. Ein CompareStoreIDs-Aufruf kann erfolgen, wenn für einen bestimmten Speicheranbieter keine Nachrichtenspeicher geöffnet sind. Darüber hinaus ruft MAPI auch CompareStoreIDs auf, wenn sie einen Speicheranbieteraufruf der IMAPISupport::OpenProfileSection-Methode verarbeitet.
Die von CompareStoreIDs verglichenen Eintragsbezeichner sind sowohl für die Dynamic Link Library (DLL) des aktuellen Speicheranbieters als auch entpackte Store-Eintragsbezeichner. Weitere Informationen zum Umschließen von Speichereintragsbezeichnern finden Sie unter IMAPISupport::WrapStoreEntryID.
Das Vergleichen von Eintragsbezeichnern ist nützlich, da ein Objekt mehr als einen gültigen Eintragsbezeichner aufweisen kann. Dies kann z. B. geschehen, nachdem eine neue Version eines Nachrichtenspeicheranbieters installiert wurde.
Siehe auch
IMAPISupport::OpenProfileSection