énumération CF_UPDATE_FLAGS (cfapi.h)
Indicateurs pour la mise à jour d’un fichier ou d’un répertoire d’espace réservé.
Syntax
typedef enum CF_UPDATE_FLAGS {
CF_UPDATE_FLAG_NONE,
CF_UPDATE_FLAG_VERIFY_IN_SYNC,
CF_UPDATE_FLAG_MARK_IN_SYNC,
CF_UPDATE_FLAG_DEHYDRATE,
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION,
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION,
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY,
CF_UPDATE_FLAG_CLEAR_IN_SYNC,
CF_UPDATE_FLAG_REMOVE_PROPERTY,
CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA,
CF_UPDATE_FLAG_ALWAYS_FULL,
CF_UPDATE_FLAG_ALLOW_PARTIAL
} ;
Constantes
CF_UPDATE_FLAG_NONE0x00000000Aucun indicateur de mise à jour. |
CF_UPDATE_FLAG_VERIFY_IN_SYNC0x00000001La mise à jour échoue si l’attribut CF_UPDATE_FLAG_MARK_IN_SYNC n’est pas défini sur l’espace réservé. Cela permet d’éviter une course entre la synchronisation des modifications du cloud vers un espace réservé local et la modification locale du flux de données de l’espace réservé. |
CF_UPDATE_FLAG_MARK_IN_SYNC0x00000002La plateforme marque l’espace réservé comme étant synchronisé lors d’une opération de mise à jour réussie de l’espace réservé. |
CF_UPDATE_FLAG_DEHYDRATE0x00000004Applicable uniquement aux fichiers. Lorsqu’elle est spécifiée, la plateforme déshydrate le fichier après la mise à jour de l’espace réservé. L’appelant doit acquérir un handle exclusif lors de la spécification de cet indicateur ou des altérations de données peuvent se produire. Notez que la plateforme ne valide pas l’exclusivité du handle. |
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION0x00000008Applicable uniquement aux répertoires. Lorsqu’il est spécifié, il marque le répertoire d’espace réservé mis à jour partiellement renseigné de sorte que tout accès futur à celui-ci entraîne un rappel FETCH_PLACEHOLDERS envoyé au fournisseur de synchronisation. |
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION0x00000010Applicable uniquement aux répertoires. Lorsqu’il est spécifié, il marque le répertoire d’espace réservé mis à jour entièrement rempli, de sorte que tout accès futur à celui-ci sera géré par la plateforme sans aucun rappel au fournisseur de synchronisation. |
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY0x00000020Lorsqu’ils sont spécifiés, FileIdentity et FileIdentityLength dans CfUpdatePlaceholder sont ignorés et la plateforme supprime l’objet blob d’identité de fichier existant sur l’espace réservé lors d’un appel de mise à jour réussi. |
CF_UPDATE_FLAG_CLEAR_IN_SYNC0x00000040La plateforme marque l’espace réservé comme non synchronisé lors d’une opération d’espace réservé de mise à jour réussie. |
CF_UPDATE_FLAG_REMOVE_PROPERTY0x00000080La plateforme supprime toutes les propriétés extrinsèques existantes sur l’espace réservé. REMARQUE Cette valeur est disponible dans Windows 10, version 1803 et ultérieure. |
CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA0x00000100La plateforme transmet CF_FS_METADATA au système de fichiers sans filtrage ; sinon, la plateforme ignore la définition de tous les champs dont la valeur est 0. REMARQUE Cette valeur est disponible dans Windows 10, version 1803 et ultérieure. |
CF_UPDATE_FLAG_ALWAYS_FULL0x00000200CF_UPDATE_FLAG_ALWAYS_FULL n’est effectif que sur les fichiers d’espace réservé. Lorsqu’il est spécifié, l’espace réservé à mettre à jour est toujours marqué plein. Une fois hydraté, toute tentative de déshydrater un tel fichier d’espace réservé échoue avec le code ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWEDd’erreur . |
CF_UPDATE_FLAG_ALLOW_PARTIAL0x00000400CF_UPDATE_FLAG_ALLOW_PARTIAL n’est effectif que sur les fichiers d’espace réservé. Lorsqu’il est spécifié, l’état toujours complet d’un fichier d’espace réservé, s’il est présent, est effacé, ce qui lui permet d’être à nouveau déshydraté. Il n’est pas valide de spécifier cet indicateur avec CF_UPDATE_FLAG_ALWAYS_FULL et le code ERROR_CLOUD_FILE_INVALID_REQUEST d’erreur sera retourné en conséquence. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1709 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2016 (applications de bureau uniquement) |
| En-tête | cfapi.h |