Использование диспетчера синхронизации из программы

Чтобы приложение работало с диспетчером синхронизации, необходимо реализовать объект модели COM для управления уведомлениями синхронизации, получаемыми от Синкмгр. Обработчик приложения выполняет синхронизацию для обрабатываемых элементов. Включается в обработчик, поэтому необходимо реализовать интерфейс исинкмгрсинчронизе . Кроме того, необходимо предоставить объект перечислителя и исинкмгренумитемс для всех отдельных элементов, которые может синхронизировать приложение.

Синкмгр реализует исинкмгрсинчронизекаллбакк и исинкмгрсинчронизеинвоке.

Синкмгр вызывает методы в исинкмгрсинчронизе для получения информации о элементах, обрабатываемых приложением, и о обработчике, который вы предоставляете для синхронизации этих элементов.

Во время выполнения процесс синхронизации выполняется следующим образом.

  1. Синкмгр уведомляет ваше приложение о том, что время синхронизации происходит для одного из элементов, обрабатываемых приложением путем вызова метода исинкмгрсинчронизе:: Initialize .
  2. Синкмгр вызывает исинкмгрсинчронизе:: енумсинкмгритемс , чтобы получить интерфейс исинкмгренумитемс для элементов, обрабатываемых приложением.
  3. Синкмгр вызывает исинкмгрсинчронизе:: сетпрогресскаллбакк , чтобы предоставить обработчику указатель интерфейса для интерфейса исинкмгрсинчронизекаллбакк . Обработчик использует этот интерфейс для обратного вызова Синкмгр во время синхронизации.
  4. Затем Синкмгр вызывает метод исинкмгрсинчронизе::P репарефорсинк , чтобы дать обработчику возможность отобразить любой элемент пользовательского интерфейса, который необходим перед началом синхронизации. Например, в приложении электронной почты может отображаться диалоговое окно входа пользователя.
  5. Обработчик вызывает исинкмгрсинчронизекаллбакк:: енаблемоделесс до и после отображения любых элементов пользовательского интерфейса. По завершении обработчик вызывает исинкмгрсинчронизекаллбакк::P репарефорсинккомплетед .
  6. Синкмгр вызывает метод исинкмгрсинчронизе:: Synchronize для запуска синхронизации.

Во время процесса синхронизации Синкмгр будет вызывать методы в интерфейсе исинкмгрсинчронизе . Он может отправлять ошибки обработчика, ход выполнения и уведомления. Он также может перечислять элементы, обрабатываемые приложением, или разрешать приложению отображать свойства элементов.

Обработчик вызывает методы в исинкмгрсинчронизекаллбакк , чтобы определить, следует ли пропускать элемент, записывать ошибки и отправлять сведения о ходе выполнения в процессе синхронизации.

Дополнительные сведения см. в соответствующих справочных страницах по используемым интерфейсам.

По завершении синхронизации обработчик вызывает исинкмгрсинчронизекаллбакк:: синчронизекомплетед.