Interface IFileSyncScopeFilter
Définit les filtres qui peuvent être utilisés pour inclure ou exclure des fichiers et des dossiers de l'étendue de la synchronisation statique.
Syntaxe
interface IFileSyncScopeFilter : IUnknown
Membres
Méthodes IFileSyncScopeFilter |
Description |
|---|---|
Définit la collection de noms de fichiers à exclure de l'étendue. |
|
Définit la collection de chemins d'accès relatifs de répertoires à exclure de l'étendue. |
|
Définit les attributs qui sont utilisés pour exclure des fichiers et des dossiers de l'étendue. |
|
Définit la collection de noms de fichiers à inclure explicitement dans l'étendue. |
|
Obtient la collection de noms de fichiers à exclure de l'étendue. |
|
Obtient la collection de chemins d'accès relatifs de répertoires à exclure de l'étendue. |
|
Obtient les attributs qui sont utilisés pour exclure des fichiers et des dossiers de l'étendue. |
|
Obtient la collection de noms de fichiers à inclure explicitement dans l'étendue. |
Notes
Les filtres statiques sont utilisés lors de la détection de modifications et sont également appliqués à tous les éléments de l'étendue de la synchronisation. Pour qu'un élément soit inclus dans la synchronisation, il doit passer tous les filtres statiques. Par exemple, si un fichier est à la fois explicitement exclu et explicitement inclus, le fichier sera exclu de l'étendue.
Le même filtre d'étendue doit être utilisé sur tous les fournisseurs dans une communauté de synchronisation. Sinon, un comportement indésirable risque de se produire.
Le filtre passé à IFileSyncProvider::Initialize est utilisé pour initialiser l'objet de fournisseur selon le filtre d'étendue qui est passé. Les modifications ultérieures apportées au filtre n'affecteront pas le filtre d'étendue utilisé par cette instance du fournisseur. Pour modifier le filtre d'étendue utilisé, vous devez créer un nouvel objet IFileSyncProvider.
Le fait de modifier l'étendue d'un réplica après la première synchronisation peut provoquer des effets secondaires involontaires. Par exemple, supposons que quelque temps après la première synchronisation vous modifiez l'étendue sur le réplica A pour commencer à exclure * .txt. Tous les fichiers qui ont une extension .txt seront alors traités par le réplica A comme étant supprimés. Aucun fichier ne sera supprimé réellement du réplica A. Cependant, les métadonnées pour A contiendront des objets tombstone pour les fichiers .txt, et A enverra des modifications de suppression à d'autres réplicas pour les fichiers .txt. Si vous excluez également * .txt sur le réplica B, l'opération restera sans effet, parce que B filtrera les modifications provenant de A et qui concernent les fichiers .txt. Toutefois, si le réplica B ne change pas son filtre, les fichiers supprimés arriveront jusqu'à lui, seront traités comme de véritables demandes de modifications et supprimés du réplica B.
Spécifications
En-tête : FileSyncProvider.h