Interfaz IFileSyncProvider
Es un proveedor de sincronización filtrada sincrónica que se puede usar para sincronizar archivos, carpetas y subcarpetas en sistemas de archivos NTFS, FAT o SMB.
interface IFileSyncProvider : IKnowledgeSyncProvider
Miembros
| Métodos de IFileSyncProvider | Descripción |
|---|---|
Inicializa una nueva instancia de IFileSyncProvider que está basada en la carpeta que se va a sincronizar y en otras opciones de configuración. |
|
Desencadena una enumeración de la réplica del sistema de archivos local para los cambios y actualiza los metadatos adecuadamente. |
|
Establece un valor que indica si el proveedor está en el modo de vista previa. |
|
Crea un nuevo objeto IFileSyncScopeFilter que se puede pasar a Initialize después de establecer sus propiedades de filtro. |
Notas
Para sincronizar todos los archivos y subcarpetas de un directorio, pase el identificador de réplica y el directorio raíz a IFileSyncProvider::Initialize, pase el proveedor a IApplicationSyncServices::CreateSyncSession y use el objeto ISyncSession devuelto para controlar la sesión de sincronización.
De forma predeterminada, los metadatos de sincronización se almacenan en un archivo de base de datos de Metadata Storage Service en el directorio raíz de la réplica. Para personalizar la ubicación y el nombre de este archivo, especifíquelos mediante Initialize.
Para controlar qué archivos y carpetas se incluyen en el ámbito de sincronización, puede configurar un objeto IFileSyncScopeFilter y pasárselo a Initialize. El filtro contiene propiedades que se pueden usar para excluir una lista de archivos, una lista de carpetas, o archivos y carpetas basándose en sus atributos, así como para incluir explícitamente una lista de archivos.
Existen diversas opciones de configuración, FILESYNC_INIT_FLAGS, que permiten controlar el comportamiento del proveedor durante la sincronización; por ejemplo, si mueve los archivos eliminados a la papelera de reciclaje o los elimina del sistema de archivos de forma permanente.
Si una aplicación desea mostrar el progreso u omitir dinámicamente determinados cambios durante la sesión, dispone de diversos eventos para ello.
Para activar el modo de vista previa para el proveedor, basta con pasar TRUE a IFileSyncProvider::SetPreviewMode antes de iniciar la sincronización. Mientras esté activado el modo de vista previa, el proveedor realizará todas las acciones como si se estuviera produciendo una sesión de sincronización real, incluso desencadenará todos los eventos. Sin embargo, el proveedor en realidad no aplicará ningún cambio a la réplica de destino.
Nota
No se admiten las operaciones de sincronización simultáneas con el mismo almacén de archivos. Si previamente se inicializó otra instancia del proveedor con la misma réplica (es decir, con los mismos valores para la ruta de acceso del directorio y la ruta de acceso del archivo de metadatos), pero no se ha liberado todavía, Initialize devolverá SYNC_METADATA_E_REPLICA_IN_USE.
Requisitos
Encabezado: FileSyncProvider.h