MAPI Progress Indicators
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Many of the operations that you perform for clients can take a long time to complete. To inform clients of the progress of a lengthy operation, you can show an indicator that displays graphically the finished portion of an operation at any given point from the start of the operation to its completion. The progress indicator shows a percentage of the total operation to be completed.
The following methods support lengthy operations and the display of a progress indicator:
IMAPIFolder::CopyMessages, IMAPIFolder::CopyFolder, IMAPIFolder::DeleteMessages, IMAPIFolder::DeleteFolder, IMAPIFolder::EmptyFolder, and IMAPIFolder::SetReadFlags.
IMAPISupport::DoCopyProps, IMAPISupport::DoCopyTo, IMAPISupport::CopyFolder, and IMAPISupport::CopyMessages.
To display a progress indicator, MAPI defines a progress object. Progress objects implement the IMAPIProgress : IUnknown interface, an interface that includes methods for establishing the range of the indicator and creating the display. MAPI provides a progress object implementation as do some clients. You should use a client's implementation, if one is supplied, as an input parameter to the method performing the operation. If the client passes NULL instead of a pointer to a progress object, use MAPI's implementation by calling the IMAPISupport::DoProgressDialog method.