Interfaccia IFileSyncScopeFilter
Definisce i filtri che possono essere utilizzati per includere o escludere file e cartelle dall'ambito di sincronizzazione statico.
interface IFileSyncScopeFilter : IUnknown
Membri
| Metodi IFileSyncScopeFilter | Descrizione |
|---|---|
Imposta la raccolta di nomi di file da escludere dall'ambito. |
|
Imposta la raccolta di percorsi relativi di directory da escludere dall'ambito. |
|
Imposta gli attributi utilizzati per escludere file e cartelle dall'ambito. |
|
Imposta la raccolta di nomi di file da includere nell'ambito in modo esplicito. |
|
Ottiene la raccolta di nomi di file da escludere dall'ambito. |
|
Ottiene la raccolta di percorsi relativi di directory da escludere dall'ambito. |
|
Ottiene gli attributi utilizzati per escludere file e cartelle dall'ambito. |
|
Ottiene la raccolta di nomi di file da includere nell'ambito in modo esplicito. |
Osservazioni
I filtri statici vengono utilizzati durante il rilevamento delle modifiche e vengono applicati equamente a tutti gli elementi nell'ambito della sincronizzazione. Un elemento viene incluso nella sincronizzazione se soddisfa i requisiti di tutti i filtri statici. Se ad esempio un file viene sia escluso sia incluso in modo esplicito, verrà escluso dall'ambito.
Lo stesso filtro ambito deve essere utilizzato su tutti i provider di una community di sincronizzazione. In caso contrario, potrebbe verificarsi un comportamento indesiderato.
Il filtro passato a IFileSyncProvider::Initialize viene utilizzato per inizializzare l'oggetto provider in base al filtro ambito al momento del passaggio. Tutte le modifiche successive al filtro non influiranno sul filtro ambito utilizzato da quell'istanza del provider. Per modificare il filtro ambito utilizzato, è necessario creare un nuovo oggetto IFileSyncProvider.
La modifica dell'ambito di una replica dopo la prima sincronizzazione può causare effetti imprevisti. Se dopo la prima sincronizzazione si modifica l'ambito della replica A per escludere * .txt, tutti i file con estensione txt verranno considerati come eliminati dalla replica A. Nessun file verrà effettivamente eliminato dalla replica A, ma i metadati di A conterranno contrassegni per la rimozione definitiva per i file txt e A invierà modifiche di eliminazione ad altre repliche per i file txt. Se * .txt viene escluso anche dalla replica B, non vi sarà alcun effetto, perché B filtrerà le modifiche provenienti da A relative ai file txt. Se invece per la replica B non viene modificato il filtro, i file eliminati verranno inviati alla replica B, verranno considerati come richieste di modifica effettive e verranno eliminati dalla replica B.
Requisiti
Intestazione: Filesyncprovider.h