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

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

SyncMgr реализует ISyncMgrSynchronizeCallback и ISyncMgrSynchronizeInvoke.

Методы SyncMgr вызываются в ISyncMgrSynchronize для получения сведений об элементах, которые обрабатывает приложение, и сведений об обработчике, который предоставляется для синхронизации этих элементов.

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

1. SyncMgr уведомляет приложение о том, что синхронизация будет выполняться для одного из элементов, которые обрабатывает приложение, вызывая метод ISyncMgrSynchronize::Initialize.
2. SyncMgr вызывает ISyncMgrSynchronize::EnumSyncMgrItems, чтобы получить интерфейс ISyncMgrEnumItems для элементов, обрабатываемых приложением.
3. SyncMgr вызывает ISyncMgrSynchronize::SetProgressCallback для предоставления обработчика указателя интерфейса для интерфейса интерфейса ISyncMgrSynchronizeCallback. Обработчик использует этот интерфейс для обратного вызова SyncMgr во время синхронизации.
4. Затем SyncMgr вызывает метод ISyncMgrSynchronize::PrepareForSync, чтобы предоставить вашему обработчику возможность отобразить любой элемент пользовательского интерфейса, необходимый перед началом синхронизации. Например, почтовое приложение может отображать диалоговое окно входа пользователя.
5. Обработчик вызывает ISyncMgrSynchronizeCallback::EnableModeless до и после отображения элементов пользовательского интерфейса. Обработчик вызывает ISyncMgrSynchronizeCallback::PrepareForSyncCompleted после завершения.
6. SyncMgr вызывает метод ISyncMgrSynchronize::Synchronize для запуска синхронизации.

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

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

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

После завершения синхронизации обработчик вызывает ISyncMgrSynchronizeCallback::SynchronizeCompleted.