Compartilhar via


Interface IFileSyncProvider

É um provedor de sincronização filtrado síncrono que pode ser usado para sincronizar arquivos, pastas e subpastas em NTFS, FAT ou sistemas de arquivos SMB.

interface IFileSyncProvider : IKnowledgeSyncProvider

Membros

Métodos IFileSyncProvider Descrição

IFileSyncProvider::Initialize

Inicializa uma instância nova de IFileSyncProvider com base na pasta a sincronizar e outras configurações.

IFileSyncProvider::DetectChanges

Dispara uma enumeração da réplica do sistema de arquivos local para alterações e atualiza os metadados adequadamente.

IFileSyncProvider::SetPreviewMode

Define um valor que indica se o provedor está no modo de visualização.

IFileSyncProvider::CreateNewScopeFilter

Cria um novo objeto IFileSyncScopeFilter que pode ser passado para Initialize após a definição de suas propriedades de filtragem.

Comentários

Para sincronizar todos os arquivos e as subpastas de um diretório, passe a ID de réplica e o diretório raiz para IFileSyncProvider::Initialize, passe o provedor para IApplicationSyncServices::CreateSyncSession e use o objeto ISyncSession retornado para manipular a sessão de sincronização.

Por padrão, os metadados da sincronização são armazenados em um arquivo de banco de dados do serviço de armazenamento de metadados no diretório raiz da réplica. Para personalizar o local e o nome desse arquivo, especifique-os usando Initialize.

O controle de quais arquivos e pastas são incluídos no escopo de sincronização pode ser realizado configurando um objeto IFileSyncScopeFilter e passando-o para Initialize. O filtro contém propriedades que podem ser usadas para excluir uma lista de arquivos, lista de pastas, arquivos e pastas com base nos seus atributos e incluir, explicitamente, uma lista de arquivos.

Várias opções de configuração, FILESYNC_INIT_FLAGS, estão disponíveis para controlar como o provedor se comporta durante a sincronização; por exemplo, se move arquivos excluídos para a lixeira ou os exclui permanentemente do sistema de arquivos.

Há diversos eventos disponíveis para o aplicativo que quer exibir o andamento ou ignorar, dinamicamente, alterações específicas durante a sessão.

O provedor pode ser colocado no modo de visualização, passando TRUE para IFileSyncProvider::SetPreviewMode antes de iniciar a sincronização. No modo de visualização, o provedor executará todas as ações como se uma sessão de sincronização real estivesse acontecendo, inclusive disparando todos os eventos. Porém, o provedor não aplicará nenhuma alteração à réplica de destino.

Dica

Não há suporte para operações de sincronização simultâneas para o mesmo repositório de arquivo. Se outra instância do provedor tiver sido inicializada anteriormente com a mesma réplica (isto é, com os mesmos valores para caminho de diretório e caminho de arquivo de metadados), mas ainda não estiver liberada, Initialize retornará SYNC_METADATA_E_REPLICA_IN_USE.

Requisitos

Cabeçalho: FileSyncProvider.h

Consulte também

Conceitos

Componentes de sincronização de arquivos do Sync Framework