é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_NONE 0x00000000 Aucun indicateur de mise à jour.
CF_UPDATE_FLAG_VERIFY_IN_SYNC 0x00000001 La 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_SYNC 0x00000002 La 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_DEHYDRATE 0x00000004 Applicable 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_POPULATION 0x00000008 Applicable 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_POPULATION 0x00000010 Applicable 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_IDENTITY 0x00000020 Lorsqu’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_SYNC 0x00000040 La 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_PROPERTY 0x00000080 La 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_METADATA 0x00000100 La 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_FULL 0x00000200 CF_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_PARTIAL 0x00000400 CF_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

Voir aussi

CfUpdatePlaceholder