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 eEintragsbezeichner, der verglichen werden soll.

cbEntryID2

[in] Die Größe des Eintragsbezeichners in Bytes, auf den 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 ein Aufruf der IMAPISession::OpenMsgStore-Methode verarbeitet wird. An diesem Punkt wird CompareStoreIDs aufgerufen, um zu bestimmen, welcher Profilabschnitt dem geöffneten Nachrichtenspeicher zugeordnet ist, falls zutreffend. 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 ein Speicheranbieteraufruf der IMAPISupport::OpenProfileSection-Methode verarbeitet wird.

Die von CompareStoreIDs verglichenen Eintragsbezeichner gelten beide für die Dynamic Link Library (DLL) des aktuellen Speicheranbieters und sind beide entpackte Speichereintragsbezeichner. Weitere Informationen zum Packen 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

IMAPISession::OpenMsgStore

IMAPISupport::OpenProfileSection

IMAPISupport::WrapStoreEntryID

IMSProvider : IUnknown