énumération CF_CONVERT_FLAGS (cfapi.h)

  • Article

Indicateurs de conversion de fichier/répertoire normal en fichier d’espace réservé/répertoire.

Syntaxe

typedef enum CF_CONVERT_FLAGS {
  CF_CONVERT_FLAG_NONE = 0x00000000,
  CF_CONVERT_FLAG_MARK_IN_SYNC = 0x00000001,
  CF_CONVERT_FLAG_DEHYDRATE = 0x00000002,
  CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION = 0x00000004,
  CF_CONVERT_FLAG_ALWAYS_FULL = 0x00000008,
  CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE = 0x00000010
} ;

Constantes

 
CF_CONVERT_FLAG_NONE
Valeur : 0x00000000
Aucun indicateur de conversion.
CF_CONVERT_FLAG_MARK_IN_SYNC
Valeur : 0x00000001
La plateforme marque l’espace réservé converti comme étant synchronisé avec le cloud lors d’une conversion réussie du fichier.
CF_CONVERT_FLAG_DEHYDRATE
Valeur : 0x00000002
Applicable uniquement aux fichiers. Lorsqu’elle est spécifiée, la plateforme déshydrate le fichier après l’avoir converti en 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_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
Valeur : 0x00000004
Applicable uniquement aux répertoires. Lorsqu’il est spécifié, il marque le répertoire d’espace réservé converti comme partiellement rempli, de sorte que tout accès futur à celui-ci entraîne un rappel FETCH_PLACEHOLDERS envoyé au fournisseur de synchronisation.
CF_CONVERT_FLAG_ALWAYS_FULL
Valeur : 0x00000008
Lorsque cet indicateur est présent, l’espace réservé nouvellement créé est marqué comme toujours plein. Une fois hydraté, toute tentative de déshydrater un tel espace réservé (fichier) échoue avec le code d’erreur ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED. Cet indicateur est appliqué uniquement sur un fichier d’espace réservé. Il peut être défini sur un répertoire d’espace réservé, mais il n’a aucun effet.
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
Valeur : 0x00000010
Lorsqu’elle est spécifiée, la plateforme permet à un moteur de synchronisation de convertir atomiquement un espace réservé de fichiers non cloud (avec une autre balise/données d’analyse) en espace réservé de fichiers cloud. Notez que l’API échoue normalement à convertir tout fichier sans espace réservé en espace réservé.

Combinaison **(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE		 CF_CONVERT_FLAG_DEHYDRATE)** est particulièrement utile dans les scénarios de migration lorsque certains fournisseurs migrent d’une autre plateforme vers une plateforme de fichiers cloud et qu’ils ont l’intention de convertir de manière atomique des espaces réservés hydratés sur l’ancienne plateforme en espaces réservés déshydratés sur la plateforme de fichiers cloud. Seul cet indicateur doit être passé pour convertir des espaces réservés complets en espaces réservés de fichiers cloud. Si l’ancienne plateforme implémente des fichiers complets en tant que fichiers ordinaires non réservés, cet indicateur n’est pas nécessaire. La transmission de cet indicateur sur un répertoire convertit également les répertoires en fichiers cloud, bien que l’indicateur DEHYDRATE ne s’applique pas aux répertoires.

Même lorsque la stratégie CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED a été spécifiée avec CfRegisterSyncRoot, seuls les processus inscrits/connectés à la racine de synchronisation des fichiers cloud sont autorisés à spécifier cet indicateur.

>[! REMARQUE]
>L’indicateur est pris en charge uniquement si le PlatformVersion.IntegrationNumber obtenu à partir de CfGetPlatformInfo est 0x500 ou supérieur.

Configuration requise

   
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

CfConvertToPlaceholder

CfRegisterSyncRoot

CfGetPlatformInfo