Compartilhar via


Interface IFileSyncScopeFilter

Define filtros que podem ser usados para incluir ou excluir arquivos e pastas do escopo de sincronização estático.

interface IFileSyncScopeFilter : IUnknown

Membros

Métodos IFileSyncScopeFilter Descrição

IFileSyncScopeFilter::SetFilenameExcludes

Define uma coleção de nomes de arquivos para excluir do escopo.

IFileSyncScopeFilter::SetSubDirectoryExcludes

Define uma coleção de caminhos relativos de diretórios para excluir do escopo.

IFileSyncScopeFilter::SetFileAttributeExcludeMask

Define os atributos que são usados para excluir arquivos e pastas do escopo.

IFileSyncScopeFilter::SetFilenameIncludes

Define uma coleção de nomes de arquivos para incluir explicitamente no escopo.

IFileSyncScopeFilter::GetFilenameExcludes

Obtém uma coleção de nomes de arquivos para excluir do escopo.

IFileSyncScopeFilter::GetSubDirectoryExcludes

Obtém uma coleção de caminhos relativos de diretórios para excluir do escopo.

IFileSyncScopeFilter::GetFileAttributeExcludeMask

Obtém os atributos que são usados para excluir arquivos e pastas do escopo.

IFileSyncScopeFilter::GetFilenameIncludes

Obtém uma coleção de nomes de arquivos para incluir explicitamente no escopo.

Comentários

Os filtros estáticos são usados durante detecção de alterações e são aplicados igualmente a todos os itens no escopo de sincronização. Para que um item seja incluído na sincronização, ele deve passar todos os filtros estáticos. Por exemplo, se um arquivo for explicitamente incluído e excluído, o arquivo será excluído do escopo.

O mesmo filtro de escopo deve ser usado em todos os provedores de uma comunidade de sincronização. Caso contrário, pode ocorrer um comportamento indesejado.

O filtro, que é passado para IFileSyncProvider::Initialize, é usado para inicializar o objeto do provedor com base no filtro de escopo quando ele é passado. As alterações subsequentes no filtro não afetarão o filtro de escopo que é usado por aquela instância do provedor. Para alterar o filtro de escopo que é usado, você deve criar um novo objeto IFileSyncProvider.

A alteração do escopo de uma réplica depois da primeira sincronização pode causar efeitos colaterais não intencionais. Por exemplo, suponha que algum tempo depois da primeira sincronização, você altere o escopo na réplica A para iniciar excluindo * .txt. Isso fará com que todos os arquivos que têm extensão .txt sejam tratados pela réplica A como excluídos. Nenhum arquivo será realmente excluído da réplica A. Porém, os metadados de A terão marcas de exclusão para arquivos .txt e A enviará alterações de exclusão para outras réplicas de arquivos .txt. Se você também excluir * .txt na réplica B, não haverá nenhum efeito, pois B filtrará alterações de A que pertencem a arquivos .txt. Porém, se a réplica B não alterar seu filtro, os arquivos excluídos fluirão, serão tratados como solicitações de alteração reais e serão excluídos da réplica B.

Requisitos

Cabeçalho: Filesyncprovider.h

Consulte também

Conceitos

Componentes de sincronização de arquivos do Sync Framework