Индикаторы хода выполнения MAPI
Область применения: Outlook 2013 | Outlook 2016
Многие операции, выполняемые для клиентов, могут занять много времени. Чтобы сообщить клиентам о ходе длительной операции, можно отобразить индикатор, который графически отображает завершенную часть операции в любой момент от начала операции до ее завершения. Индикатор хода выполнения показывает процент от общего числа операций, которые необходимо выполнить.
Следующие методы поддерживают длительные операции и отображение индикатора хода выполнения.
IMAPIFolder::CopyMessages, IMAPIFolder::CopyFolder, IMAPIFolder::D eleteMessages, IMAPIFolder::D eleteFolder, IMAPIFolder::EmptyFolder и IMAPIFolder::SetReadFlags.
IMAPISupport::D oCopyProps, IMAPISupport::D oCopyTo, IMAPISupport::CopyFolder и IMAPISupport::CopyMessages.
Чтобы отобразить индикатор хода выполнения, MAPI определяет объект хода выполнения. Объекты выполнения реализуют интерфейс IMAPIProgress : IUnknown , который включает методы для установки диапазона индикатора и создания дисплея. MAPI предоставляет реализацию объекта хода выполнения, как и некоторые клиенты. В качестве входного параметра метода, выполняющего операцию, следует использовать реализацию клиента, если она указана. Если клиент передает значение NULL вместо указателя на объект выполнения, используйте реализацию MAPI, вызвав метод IMAPISupport::D oProgressDialog .