IProxyStoreObject::UnwrapNoRef
Gilt für: Outlook 2013 | Outlook 2016
Ruft einen Zeiger auf ein IMAP-Speicherobjekt (Unwrapped Internet Message Access Protocol) ab, das Zugriff auf die zugrunde liegende PST-Datei (Personal Folders) ermöglicht, ohne die Synchronisierung aufzugeben und die Elemente herunterzuladen.
HRESULT IProxyStoreObject::UnwrapNoRef ( LPVOID *ppvObject );
Parameter
ppvObject
[out] Zeiger auf ein IMsgStore: IMAPIProp-Speicherobjekt , das entwrappt wird.
Rückgabewerte
S_OK
- Der Aufruf war erfolgreich, und ein Zeiger auf eine entwrappte Schnittstelle wurde in ppvObject zurückgegeben.
Hinweise
Ohne zuerst einen IMAP-Speicher zu entpacken, kann der Zugriff auf eine Nachricht im Speicher eine Synchronisierung erzwingen, bei der versucht wird, die gesamte Nachricht herunterzuladen. Die Verwendung des entwrappten Speichers ermöglicht den Zugriff auf die Nachricht im aktuellen Zustand, ohne einen Download auszulösen.
Da UnwrapNoRef die Verweisanzahl für diesen neuen Zeiger auf das unwrapped Store-Objekt nicht erhöht, sollten Sie nach dem erfolgreichen Aufruf von UnwrapNoRefIUnknown::AddRef aufrufen, um die Verweisanzahl beizubehalten.