Condividi tramite


Interfaccia IFileSyncProvider

Provider di sincronizzazione filtrata sincrona che può essere utilizzato per sincronizzare file, cartelle e sottocartelle in file system NTFS, FAT o SMB.

interface IFileSyncProvider : IKnowledgeSyncProvider

Membri

Metodi IFileSyncProvider Descrizione

IFileSyncProvider::Initialize

Inizializza una nuova istanza di IFileSyncProvider basata sulla cartella da sincronizzare e su altre impostazioni.

IFileSyncProvider::DetectChanges

Genera un'enumerazione della replica del file system locale in relazione alle modifiche e aggiorna di conseguenza i metadati.

IFileSyncProvider::SetPreviewMode

Imposta un valore che indica se il provider si trova in modalità anteprima.

IFileSyncProvider::CreateNewScopeFilter

Crea un nuovo oggetto IFileSyncScopeFilter che può essere passato a Initialize dopo l'impostazione delle relative proprietà del filtro.

Osservazioni

Per sincronizzare tutti i file e le sottocartelle di una directory, passare l'ID replica e la directory radice a IFileSyncProvider::Initialize, passare il provider a IApplicationSyncServices::CreateSyncSession e utilizzare l'oggetto ISyncSession restituito per gestire la sessione di sincronizzazione.

Per impostazione predefinita, i metadati di sincronizzazione sono archiviati in un file di database del servizio di archiviazione dei metadati nella directory radice della replica. Per personalizzare il percorso e il nome del file, specificare tali informazioni tramite Initialize.

Il controllo dei file e delle cartelle inclusi nell'ambito della sincronizzazione può essere garantito configurando un oggetto IFileSyncScopeFilter e passandolo a Initialize. Il filtro contiene proprietà utilizzabili per escludere un elenco di file, un elenco di cartelle e file e cartelle in base ai relativi attributi, nonché per includere in modo esplicito un elenco di file.

Sono disponibili diverse opzioni di configurazione FILESYNC_INIT_FLAGS che consentono di controllare il comportamento del provider durante la sincronizzazione, ad esempio se i file eliminati vengono spostati nel cestino oppure eliminati in modo definitivo dal file system.

Per le applicazioni in cui è necessario visualizzare lo stato di avanzamento o ignorare in modo dinamico determinate modifiche durante la sessione, è disponibile un'ampia gamma di eventi.

Il provider può essere utilizzato in modalità anteprima passando TRUE a IFileSyncProvider::SetPreviewMode prima di avviare la sincronizzazione. In modalità anteprima il provider eseguirà tutte le azioni di una sessione di sincronizzazione reale, inclusa la generazione di tutti gli eventi, ma non applicherà alcuna modifica alla replica di destinazione.

Nota

Le operazioni di sincronizzazione simultanee non sono supportate nello stesso archivio file. Se un'altra istanza del provider è stata inizializzata in precedenza con la stessa replica, ovvero gli stessi valori per il percorso di directory e il percorso di file dei metadati, ma non è ancora stata rilasciata, Initialize restituirà SYNC_METADATA_E_REPLICA_IN_USE.

Requisiti

Intestazione: FileSyncProvider.h

Vedere anche

Concetti

Componenti di Sync Services for File Systems