Интерфейс IFileSyncProvider
Представляет собой службу синхронизации с синхронной фильтрацией, которая может использоваться для синхронизации файлов, папок и вложенных папок в файловых системах NTFS, FAT или SMB.
interface IFileSyncProvider : IKnowledgeSyncProvider
Элементы
Методы IFileSyncProvider | Описание |
---|---|
Инициализирует новый экземпляр IFileSyncProvider на основе синхронизируемой папки и других параметров. |
|
Запускает перечисление изменений в локальной реплике файловой системы и соответствующим образом обновляет метаданные. |
|
Задает значение, которое указывает, находится ли поставщик в режиме предварительного просмотра. |
|
Создает новый объект IFileSyncScopeFilter, который может быть передан методу Initialize после установки свойств фильтра. |
Замечания
Для синхронизации всех файлов и вложенных папок в каталоге передайте идентификатор реплики и имя корневого каталога методу IFileSyncProvider::Initialize, передайте поставщик методу IApplicationSyncServices::CreateSyncSession, а затем пользуйтесь возвращенным объектом ISyncSession для работы с сеансом синхронизации.
По умолчанию метаданные синхронизации хранятся в файле базы данных службы хранилища метаданных в корневом каталоге реплики. Чтобы задать другое расположение и имя этого файла, укажите их при вызове метода Initialize.
Управляет включением файлов и папок в область синхронизации и может осуществляться путем настройки объекта IFileSyncScopeFilter и передачи его методу Initialize. Фильтр содержит свойства, которые могут использоваться для исключения списка файлов, исключения списка папок, исключения файлов и папок на основании их атрибутов, и явного включения списка файлов.
Для управления работой службы во время синхронизации может применяться ряд параметров конфигурации, FILESYNC_INIT_FLAGS, которые, например, указывают, происходит ли перемещение удаляемых файлов в корзину или их удаление из файловой системы без возможности восстановления.
Если в приложении в течение сеанса необходимо обеспечить отображение хода выполнения или динамический пропуск определенных изменений, то это можно сделать через различные события.
Службу можно перевести в режим предварительного просмотра, передав значение TRUE методу IFileSyncProvider::SetPreviewMode перед началом синхронизации. В процессе работы в режиме предварительного просмотра служба выполняет все действия таким образом, как если бы происходил реальный сеанс синхронизации, включая вызов всех событий. Однако фактически никакие изменения к реплике назначения не применяются.
Примечание. |
---|
Параллельная синхронизация одного и того же хранилища файлов не поддерживаются. Если ранее был инициализирован и еще не освобожден другой экземпляр службы с той же репликой (то есть с теми же значениями пути к каталогу и пути к файлу метаданных), то метод Initialize вернет значение SYNC_METADATA_E_REPLICA_IN_USE. |
Системные требования
Заголовок: FileSyncProvider.h