Поделиться через


Интерфейс IFileSyncProvider

Представляет собой службу синхронизации с синхронной фильтрацией, которая может использоваться для синхронизации файлов, папок и вложенных папок в файловых системах NTFS, FAT или SMB.

interface IFileSyncProvider : IKnowledgeSyncProvider

Элементы

Методы IFileSyncProvider Описание

IFileSyncProvider::Initialize

Инициализирует новый экземпляр IFileSyncProvider на основе синхронизируемой папки и других параметров.

IFileSyncProvider::DetectChanges

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

IFileSyncProvider::SetPreviewMode

Задает значение, которое указывает, находится ли поставщик в режиме предварительного просмотра.

IFileSyncProvider::CreateNewScopeFilter

Создает новый объект IFileSyncScopeFilter, который может быть передан методу Initialize после установки свойств фильтра.

Замечания

Для синхронизации всех файлов и вложенных папок в каталоге передайте идентификатор реплики и имя корневого каталога методу IFileSyncProvider::Initialize, передайте поставщик методу IApplicationSyncServices::CreateSyncSession, а затем пользуйтесь возвращенным объектом ISyncSession для работы с сеансом синхронизации.

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

Управляет включением файлов и папок в область синхронизации и может осуществляться путем настройки объекта IFileSyncScopeFilter и передачи его методу Initialize. Фильтр содержит свойства, которые могут использоваться для исключения списка файлов, исключения списка папок, исключения файлов и папок на основании их атрибутов, и явного включения списка файлов.

Для управления работой службы во время синхронизации может применяться ряд параметров конфигурации, FILESYNC_INIT_FLAGS, которые, например, указывают, происходит ли перемещение удаляемых файлов в корзину или их удаление из файловой системы без возможности восстановления.

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

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

NoteПримечание.

Параллельная синхронизация одного и того же хранилища файлов не поддерживаются. Если ранее был инициализирован и еще не освобожден другой экземпляр службы с той же репликой (то есть с теми же значениями пути к каталогу и пути к файлу метаданных), то метод Initialize вернет значение SYNC_METADATA_E_REPLICA_IN_USE.

Системные требования

Заголовок: FileSyncProvider.h

См. также

Основные положения

Компоненты синхронизации файлов Sync Framework