Search Office
Sign in
Home Products Office 365 Docs Samples Downloads Training How To Support Forums
Office and SharePoint development > Office client development > Office 2013 > Outlook 2013 > Outlook 2013 MAPI Reference > MAPI Reference > MAPI Interfaces > IProxyStoreObject > IProxyStoreObject::UnwrapNoRef
This topic has not yet been rated - Rate this topic

IProxyStoreObject::UnwrapNoRef

Office 2013

Published: July 16, 2012

Gets a pointer to an unwrapped Internet Message Access Protocol (IMAP) store object that provides access to the underlying Personal Folders file (PST) without invoking synchronization and downloading the items.

C++
Copy 
HRESULT IProxyStoreObject::UnwrapNoRef (     LPVOID *ppvObject );
ppvObject

[out] Pointer to an IMsgStore : IMAPIProp store object that is unwrapped.

S_OK

  • The call was successful and a pointer to an unwrapped interface has been returned in ppvObject.

Without first unwrapping an IMAP store, accessing a message in the store can force a synchronization that attempts to download the entire message. Using the unwrapped store allows access to the message in its current state without triggering a download.

Because UnwrapNoRef does not increment the reference count for this new pointer to the unwrapped store object, after successfully calling UnwrapNoRef, you should call IUnknown::AddRef to maintain the reference count.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.