Article ID: 912238 - View products that this article applies to.
This article has been archived. It is offered "as is" and will no longer be updated.
When you configure Microsoft Office Outlook 2003 to connect to an IMAP server, messages are downloaded to a personal folder (.pst) file. This article describes how to manage messages in the .pst file by using MAPI.
Messages that are downloaded to a .pst file from an IMAP server can be in one of two states:
Therefore, you must use the UnwrapNoRef function on the .pst file before you try to access messages in the .pst file. The IMsgStore interface that is returned by the UnwrapNoRef function is identical to the IMsgStore interface that is wrapped. However, when you unwrap the .pst file, you can access messages in the .pst file in the current state without triggering a download from the IMAP server.
If the QueryInterface method returns the MAPI_E_INTERFACE_NOT_SUPPORTED error, the .pst file is not wrapped.
The following are the definitions for the UnwrapNoRef function:
Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements.
To use the UnwrapNoRef function, first call the QueryInterface method on the source message store to obtain the IProxyStoreObject interface. Then, call the UnwrapNoRef function to obtain the unwrapped .pst file. Note that the UnwrapNoRef function does not call the Addref method on the returned pointer.
For more information, visit the following Microsoft Web site: