Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

IProxyStoreObject::UnwrapNoRef

Office 2007

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.

Quick Info

See IProxyStoreObject.

HRESULT IProxyStoreObject::UnwrapNoRef (
    LPVOID *ppvObject
);

Parameters

ppvObject

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

Return Values

S_OK

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

Remarks

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.

See Also

Constants for the Store API
How to: Access a Message on an IMAP Store Without Downloading the Entire Message


Community Additions

ADD
Show:
© 2015 Microsoft