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 |
|---|---|
Define uma coleção de nomes de arquivos para excluir do escopo. |
|
Define uma coleção de caminhos relativos de diretórios para excluir do escopo. |
|
Define os atributos que são usados para excluir arquivos e pastas do escopo. |
|
Define uma coleção de nomes de arquivos para incluir explicitamente no escopo. |
|
Obtém uma coleção de nomes de arquivos para excluir do escopo. |
|
Obtém uma coleção de caminhos relativos de diretórios para excluir do escopo. |
|
Obtém os atributos que são usados para excluir arquivos e pastas do escopo. |
|
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