estructura CF_SYNC_POLICIES (cfapi.h)
Define las directivas de sincronización usadas por una raíz de sincronización.
Sintaxis
typedef struct CF_SYNC_POLICIES {
ULONG StructSize;
CF_HYDRATION_POLICY Hydration;
CF_POPULATION_POLICY Population;
CF_INSYNC_POLICY InSync;
CF_HARDLINK_POLICY HardLink;
CF_PLACEHOLDER_MANAGEMENT_POLICY PlaceholderManagement;
} CF_SYNC_POLICIES;
Miembros
StructSize
Tamaño de la estructura CF_SYNC_POLICIES.
Hydration
La directiva de hidratación permite a un proveedor de sincronización controlar cómo la plataforma debe hidratar los archivos de marcador de posición. Consta de una directiva principal y un conjunto de modificadores de directiva.
La directiva principal tiene cuatro valores posibles:
| Directiva | Descripción |
|---|---|
| ALWAYS_FULL | Cuando ALWAYS_FULL se selecciona , se producirá un error en la plataforma, con HRESULT ERROR_CLOUD_FILE_INVALID_REQUEST, cualquier operación de marcador de posición que pudiera dar lugar a un marcador de posición no totalmente hidratado, que incluye CfCreatePlaceholders, CfDehydratePlaceholder, CfUpdatePlaceholder con la opción de deshidratación y CfConvertPlaceholder con la opción de deshidratación . |
| FULL | Cuando FULL se selecciona, la plataforma permitirá que un marcador de posición se deshidrate. Cuando la plataforma detecta el acceso a un marcador de posición deshidratado, se asegurará de que el contenido completo del marcador de posición esté disponible localmente antes de completar la solicitud de E/S del usuario, incluso si la solicitud solo solicita 1 byte. |
| PROGRESIVA | Cuando PROGRESSIVE se selecciona, la plataforma permitirá que un marcador de posición se deshidrate. Cuando la plataforma detecta el acceso a un marcador de posición deshidratado, completará la solicitud de E/S de usuario en cuanto determine que se reciben datos suficientes del proveedor de sincronización. Sin embargo, la plataforma promete seguir solicitando el contenido restante en el marcador de posición del proveedor de sincronización en segundo plano hasta que el contenido completo del marcador de posición esté disponible localmente o se cierre el último identificador de usuario en el marcador de posición.Tenga en PROGRESSIVE cuenta que es posible que los proveedores de sincronización que opten por no supongan que las devoluciones de llamada de hidratación llegan secuencialmente desde el desplazamiento 0. Es decir, se espera que los proveedores de sincronización con PROGRESSIVE la directiva controle las búsquedas aleatorias en el marcador de posición. |
| PARTIAL | La PARTIAL directiva es muy similar a PROGRESSIVE. La única diferencia entre los dos es la falta de hidratación continua en segundo plano con la PARTIAL directiva. |
Actualmente se admiten tres modificadores de directiva: VALIDATION_REQUIRED, STREAMING_ALLOWEDy AUTO_DEHYDRATION_ALLOWED. En general, los modificadores se pueden mezclar y coincidir con cualquier directiva principal y otros modificadores de directiva siempre que la combinación no esté en conflicto.
| Modificador de directiva | Descripción |
|---|---|
| VALIDATION_REQUIRED | Este modificador de directiva ofrece dos garantías para un proveedor de sincronización. En primer lugar, garantiza que los datos devueltos por el proveedor de sincronización siempre se conservan en el disco antes de que se devuelvan a la aplicación de usuario. En segundo lugar, permite al proveedor de sincronización recuperar los mismos datos que ha devuelto anteriormente a la plataforma y validar su integridad. Solo tras una confirmación correcta de la integridad por parte del proveedor de sincronización, la plataforma completará la solicitud de E/S del usuario. Este modificador ayuda a admitir la integridad de datos de un extremo a otro a costa de E/S de disco adicional. |
| STREAMING_ALLOWED | Este modificador de directiva concede a la plataforma el permiso para no almacenar ningún dato devuelto por un proveedor de sincronización en discos locales. Este modificador de directiva es mutuamente excluyente con VALIDATION_REQUIRED. Se produce un error en la API cuando ERROR_INVALID_PARAMETER se especifican ambas marcas. |
| AUTO_DEHYDRATION_ALLOWED | Este modificador de directiva concede a la plataforma el permiso para deshidratar los marcadores de posición de archivos en la nube sincronizados sin la ayuda de los proveedores de sincronización. Sin esta marca, la plataforma no puede llamar directamente a CfDehydratePlaceholder . En su lugar, la única manera admitida de deshidratar un marcador de posición de archivo en la nube es borrar el atributo anclado del archivo y establecer el atributo desanclado del archivo. A continuación, el motor de sincronización realizará la deshidratación real de forma asincrónica después de recibir la notificación de cambio de directorio en los dos atributos. Cuando se especifica esta marca, se permitirá que la plataforma invoque CfDehydratePlaceholder directamente en cualquier marcador de posición de archivo en la nube sincronizado. Se recomienda que los proveedores de sincronización admitan la deshidratación automática. |
| ALLOW_FULL_RESTART_HYDRATION | Este modificador de directiva concede el permiso de plataforma para hidratar completamente un archivo de forma sincrónica cuando intercepta un intento por un filtro av para examinar el archivo. Los proveedores de sincronización que quieran usar RestartHidrata para cambiar de fileSize una devolución de llamada FetchData deben optar por la ALLOW_FULL_RESTART_HYDRATION directiva para evitar posibles interbloqueos con software antivirus y antimalware que intentan examinar el archivo y el proveedor que intenta cambiar fileSize con RestartHidrata.Nota: Este modificador solo se admite si el PlatformVersion.IntegrationNumber obtenido de CfGetPlatformInfo es 0x500 o superior. |
Population
La directiva de rellenado permite a un proveedor de sincronización controlar cómo la plataforma debe crear el espacio de nombres de marcador de posición, tanto directorios como archivos. Actualmente hay tres directivas principales sin modificadores definidos:
| Directiva | Descripción |
|---|---|
| ALWAYS_FULL | Cuando ALWAYS_FULL se selecciona , la plataforma supone que el espacio de nombres completo siempre está disponible localmente. Nunca reenviará ninguna solicitud de enumeración de directorios al proveedor de sincronización. |
| FULL | Con la FULL directiva de rellenado, cuando la plataforma detecta el acceso en un directorio no rellenado completamente, solicitará al proveedor de sincronización que devuelva todas las entradas del directorio antes de completar la solicitud del usuario. |
| PARTIAL | Con la PARTIAL directiva de rellenado, cuando la plataforma detecta el acceso en un directorio no rellenado completamente, solo solicitará las entradas requeridas por la aplicación de usuario desde el proveedor de sincronización. |
InSync
La InSync directiva permite que un proveedor de sincronización controle cuándo la plataforma debe borrar el estado en sincronización en un marcador de posición. Además de borrar siempre la sincronización en cualquier modificación de datos, la plataforma actualmente puede borrar la sincronización en los cambios de cualquier combinación de tres atributos de archivo (ReadOnly, System y Hidden) y dos veces de archivo (CreateTime y LastWriteTime). Estas directivas se pueden aplicar a archivos y directorios por separado.
HardLink
De forma predeterminada, la plataforma no permite crear vínculos duros en ningún marcador de posición. Sin embargo, los proveedores de sincronización que son capaces de controlar vínculos duros pueden indicar a la plataforma que habilite la compatibilidad a través de la ALLOWED directiva. Con esta directiva, las aplicaciones pueden crear tantos vínculos duros como el sistema de archivos admita siempre que los vínculos estén en la misma raíz de sincronización o en ninguna raíz de sincronización. La plataforma obligará a hidratar un marcador de posición cuando se introduzca el primer vínculo de raíz fuera de sincronización y revertirá un marcador de posición al archivo normal cuando se quite su último vínculo raíz en sincronización. La creación de vínculos duros que no es compatible con la directiva producirá un error con HRESULT ERROR_CLOUD_FILES_INCOMPATIBLE_HARDLINKS. Las operaciones de marcador de posición que no son compatibles con la directiva también producirán un error con ERROR_CLOUD_FILES_INCOMPATIBLE_HARDLINKS.
PlaceholderManagement
De forma predeterminada, solo un proveedor de sincronización puede realizar operaciones de administración de marcadores de posición en una raíz de sincronización. Los procesos del proveedor de no sincronización solo pueden realizar operaciones de administración de marcadores de posición si la raíz de sincronización está inactiva (es decir, cuando ningún proveedor de sincronización está conectado a la raíz de sincronización). Estas directivas, cuando están habilitadas, permiten que los procesos del proveedor que no son de sincronización realicen operaciones de administración de marcadores de posición respectivas en una raíz de sincronización activa. CF_PLACEHOLDER_MANAGEMENT_POLICY_DEFAULT es la directiva predeterminada, lo que permite que solo un proveedor de sincronización conectado realice cualquier operación de administración de marcadores de posición. Las tres directivas siguientes se pueden especificar en cualquier combinación:
| Directiva | Descripción |
|---|---|
| CF_PLACEHOLDER_MANAGEMENT_POLICY_CREATE_UNRESTRICTED | Cuando se especifica esta directiva durante el registro, cualquier proceso puede crear un marcador de posición dentro de una raíz de sincronización activa llamando a CfCreatePlaceholders. |
| CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_UNRESTRICTED | Cuando se especifica esta directiva durante el registro, cualquier proceso puede convertir un archivo o un directorio dentro de una raíz de sincronización activa en un marcador de posición llamando a CfConvertToPlaceholder. |
| CF_PLACEHOLDER_MANAGEMENT_POLICY_UPDATE_UNRESTRICTED | Cuando se especifica esta directiva durante el registro, cualquier proceso puede actualizar un marcador de posición dentro de una raíz de sincronización activa a través de la API CfUpdatePlaceholder. |
Nota
Estas marcas solo se admiten si el PlatformVersion.IntegrationNumber obtenido de CfGetPlatformInfo es 0x310 o superior.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1709 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Encabezado | cfapi.h |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de