Interfaz IFileSyncScopeFilter
Define filtros que se pueden usar para incluir o excluir archivos y carpetas del ámbito de sincronización estática.
interface IFileSyncScopeFilter : IUnknown
Miembros
| Métodos de IFileSyncScopeFilter | Descripción |
|---|---|
Establece la colección de nombres de archivo que se deben excluir del ámbito. |
|
Establece la colección de rutas de acceso relativas de los directorios que se deben excluir del ámbito. |
|
Establece los atributos que se usan para excluir archivos y carpetas del ámbito. |
|
Establece la colección de nombres de archivo que se deben incluir explícitamente en el ámbito. |
|
Obtiene la colección de nombres de archivo que se deben excluir del ámbito. |
|
Obtiene la colección de rutas de acceso relativas de los directorios que se deben excluir del ámbito. |
|
Obtiene los atributos que se usan para excluir archivos y carpetas del ámbito. |
|
Obtiene la colección de nombres de archivo que se deben incluir explícitamente en el ámbito. |
Notas
Los filtros estáticos se usan durante la detección de cambios y se aplican por igual a todos los elementos del ámbito de sincronización. Para que un elemento se incluya en la sincronización, debe pasar por todos los filtros estáticos. Por ejemplo, si un archivo se excluye explícitamente y también se incluye explícitamente, se excluirá del ámbito.
Se debe usar el mismo filtro del ámbito en todos los proveedores de una comunidad de sincronización. En caso contrario, se podría producir un comportamiento no deseado.
El filtro que se pasa a IFileSyncProvider::Initialize se usa para inicializar el objeto de proveedor basándose en el filtro del ámbito existente en el momento en que se pasa. Los cambios subsiguientes realizados en el filtro no afectarán al filtro del ámbito usado por esa instancia del proveedor. Para cambiar el filtro del ámbito que se usa, debe crear un nuevo objeto IFileSyncProvider.
Si se cambia el ámbito de una réplica después de la primera sincronización, pueden producirse efectos secundarios imprevistos. Por ejemplo, suponga que, algún tiempo después de la primera sincronización, cambia el ámbito de la réplica A para que comience a excluir * .txt. Esto hará que la réplica A considere que están eliminados todos los archivos que tienen una extensión .txt. En realidad, no se eliminará ningún archivo de la réplica A. Sin embargo, los metadatos de A contendrán marcadores de exclusión para los archivos .txt y A enviará cambios de eliminación a las demás réplicas para los archivos .txt. Si también excluye * .txt de la réplica B, no se produce ningún efecto, porque B filtrará los cambios de A relacionados con los archivos .txt. Sin embargo, si la réplica B no cambia su filtro, recibirá los archivos eliminados, que se considerarán solicitudes de cambio reales y serán eliminados de la réplica B.
Requisitos
Encabezado: FileSyncProvider.h