IMAPISupport::WrapStoreEntryID
Gilt für: Outlook 2013 | Outlook 2016
Konvertiert den internen Eintragsbezeichner eines Nachrichtenspeichers in einen Eintragsbezeichner im MAPI-Standardformat.
HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);
Parameter
cbOrigEntry
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpOrigEntry-Parameter verweist.
lpOrigEntry
[in] Ein Zeiger auf den privaten Eintragsbezeichner für den Nachrichtenspeicher.
lpcbWrappedEntry
[out] Ein Zeiger auf die Byteanzahl im Eintragsbezeichner, auf den der lppWrappedEntry-Parameter verweist.
lppWrappedEntry
[out] Ein Zeiger auf einen Zeiger auf den umschlossenen Eintragsbezeichner.
Rückgabewert
S_OK
Der Eintragsbezeichner wurde erfolgreich umschlossen.
Hinweise
Die IMAPISupport::WrapStoreEntryID-Methode wird für alle Dienstanbieterunterstützungsobjekte implementiert. Dienstanbieter verwenden WrapStoreEntryID , um MAPI einen Eintragsbezeichner für einen Nachrichtenspeicher zu generieren, der den internen Eintragsbezeichner des Speichers umschließt.
Hinweise für Aufrufer
Wenn ein Client die IMAPIProp::GetProps-Methode Ihres Nachrichtenspeichers aufruft, um seine PR_STORE_ENTRYID (PidTagStoreEntryId)-Eigenschaft abzurufen, und Ihr Nachrichtenspeicher einen Eintragsbezeichner in einem privaten Format verwendet, rufen Sie WrapStoreEntryID auf, und geben Sie den Eintragsbezeichner zurück, auf den der lppWrappedEntry-Parameter verweist.
Aufrufe der Methoden IMSProvider::Logon und IMSLogon::CompareEntryIDs rufen immer den privaten Eintragsbezeichner des Speichers ab. Die umschlossene Version wird nur zwischen Clientanwendungen und MAPI verwendet.
Geben Sie den Speicher für den Eintragsbezeichner frei, auf den der lppWrappedEntry-Parameter verweist, indem Sie die MAPIFreeBuffer-Funktion verwenden, wenn Sie die Verwendung des Eintragsbezeichners abgeschlossen haben.