Interface IFileSyncProvider
Il s'agit d'un fournisseur de synchronisation filtrée synchrone qui peut être utilisé pour synchroniser des fichiers, des dossiers et des sous-dossiers dans les systèmes de fichiers NTFS, FAT ou SMB.
Syntaxe
interface IFileSyncProvider : IKnowledgeSyncProvider
Membres
Méthodes IFileSyncProvider |
Description |
|---|---|
Initialise une nouvelle instance de IFileSyncProvider qui se base sur le dossier à synchroniser et d'autres paramètres. |
|
Déclenche une énumération du réplica de système de fichiers local pour connaître les modifications et met à jour les métadonnées en conséquence. |
|
Définit une valeur qui indique si le fournisseur est ou non en mode Aperçu. |
|
Crée un nouvel objet IFileSyncScopeFilter qui peut être passé à Initialize après la définition de ses propriétés de filtre. |
Notes
Pour synchroniser tous les fichiers et sous-dossiers d'un répertoire, passez l'ID de réplica et le répertoire racine à IFileSyncProvider::Initialize, passez le fournisseur à IApplicationSyncServices::CreateSyncSession et utilisez l'objet ISyncSession retourné pour gérer la session de synchronisation.
Par défaut, les métadonnées de synchronisation sont stockées dans un fichier de base de données du service de stockage des métadonnées, dans le répertoire racine du réplica. Pour personnaliser l'emplacement et le nom de ce fichier, spécifiez-les en utilisant Initialize.
Vous pouvez contrôler les fichiers et dossiers qui sont inclus dans l'étendue de synchronisation en configurant un objet IFileSyncScopeFilter et en le passant à Initialize. Le filtre contient des propriétés qui peuvent être utilisées pour exclure une liste de fichiers, exclure une liste de dossiers, exclure des fichiers et dossiers en fonction de leurs attributs, ainsi que pour inclure explicitement une liste de fichiers.
Plusieurs options de configuration (FILESYNC_INIT_FLAGS) sont disponibles pour contrôler le comportement du fournisseur pendant la synchronisation, par exemple pour déterminer s'il déplace les fichiers supprimés vers la Corbeille ou les supprime définitivement du système de fichiers.
L'application dispose de divers événements pour afficher la progression ou l'omission dynamique de modifications données pendant la session.
Le fournisseur peut être mis en mode Aperçu en passant la valeur TRUE à IFileSyncProvider::SetPreviewMode avant de démarrer la synchronisation. En mode Aperçu, le fournisseur effectuera toutes les actions comme dans une session de synchronisation réelle, y compris le déclenchement de tous les événements. Toutefois, le fournisseur n'applique pas réellement les modifications au réplica de destination.
Notes
Les opérations de synchronisation simultanées au même magasin de fichiers ne sont pas prises en charge. Si une autre instance de fournisseur a été précédemment initialisée avec le même réplica (autrement dit, les mêmes valeurs sont utilisées pour le chemin d'accès au répertoire et au fichier de métadonnées), mais n'a pas encore été libérée, Initialize retournera SYNC_METADATA_E_REPLICA_IN_USE.
Spécifications
En-tête : FileSyncProvider.h