WrapStoreEntryID

Gilt für: Outlook 2013 | Outlook 2016

Konvertiert den internen Eintragsbezeichner eines Nachrichtenspeichers in einen Eintragsbezeichner, der vom Messagingsystem besser verwendet werden kann.

WrapStoreEntryID(
  ULONG ulFlags,
  LPSTR szDLLName,
  ULONG cbOrigEntry,
  LPENTRYID lpOrigEntry,
  ULONG * lpcbWrappedEntry,
  LPENTRYID * lppWrappedEntry
);

Parameter

ulFlags

[in] Bitmaske von Flags. Das folgende Flag kann festgelegt werden:

MAPI_UNICODE

Die Zeichenfolgen liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.

szDLLName

[in] Der Name der Dll des Nachrichtenspeicheranbieters.

cbOrigEntry

[in] Größe des ursprünglichen Eintragsbezeichners für den Nachrichtenspeicher in Bytes.

lpOrigEntry

[in] Zeiger auf eine ENTRYID-Struktur , die den ursprünglichen Eintragsbezeichner enthält.

lpcbWrappedEntry

[out] Zeiger auf die Größe des neuen Eintragsbezeichners in Bytes.

lppWrappedEntry

[out] Zeiger auf einen Zeiger auf eine ENTRYID-Struktur , die den neuen Eintragsbezeichner enthält.

Rückgabewert

None.

Hinweise

Ein Nachrichtenspeicherobjekt behält einen internen Eintragsbezeichner bei, der nur für den Dienstanbieter coresident mit diesem Nachrichtenspeicher von Bedeutung ist. Für andere Messagingkomponenten stellt MAPI eine umschlossene Version des internen Eintragsbezeichners bereit, die ihn als zum Nachrichtenspeicher gehört erkennbar macht. Coresident-Dienstanbieter sollten immer den ursprünglichen Eintragsbezeichner für den unwrrappten Nachrichtenspeicher erhalten. Clientanwendungen sollten immer die umschlossene Version erhalten, die dann überall in der Messagingdomäne und in anderen Domänen verwendet werden kann.

Ein Dienstanbieter kann einen Eintragsbezeichner für den Nachrichtenspeicher mithilfe der WrapStoreEntryID-Funktion oder der IMAPISupport::WrapStoreEntryID-Methode umschließen , die die WrapStoreEntryID-Funktion aufruft. Der Anbieter muss den Eintragsbezeichner umschließen, wenn die PR_ENTRYID (PidTagEntryId)-Eigenschaft des Nachrichtenspeichers verfügbar macht oder in einen Profilabschnitt geschrieben wird, und wenn die eigenschaft PR_STORE_ENTRYID (PidTagStoreEntryId) verfügbar ist. MAPI umschließt einen Eintragsbezeichner für den Nachrichtenspeicher, wenn auf einen IMAPISession::OpenMsgStore-Aufruf reagiert wird.

Wenn eine Clientanwendung einen umschlossenen Nachrichtenspeichereintragsbezeichner an MAPI übergibt, z. B. in einem IMAPISession::OpenEntry-Aufruf , entpackt MAPI den Eintragsbezeichner, bevor er zum Aufrufen einer Anbietermethode wie IMSProvider::Logon oder IMSProvider::CompareStoreIDs verwendet wird.