enumerazione CF_CONVERT_FLAGS (cfapi.h)

  • Articolo

File/directory normale per contrassegni di conversione file/directory segnaposto.

Sintassi

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
} ;

Costanti

 
CF_CONVERT_FLAG_NONE
Valore: 0x00000000
Nessun flag di conversione.
CF_CONVERT_FLAG_MARK_IN_SYNC
Valore: 0x00000001
La piattaforma contrassegna il segnaposto convertito come in sincronizzazione con il cloud dopo una conversione riuscita del file.
CF_CONVERT_FLAG_DEHYDRATE
Valore: 0x00000002
Applicabile solo ai file. Se specificato, la piattaforma disidrata il file dopo la conversione in un segnaposto correttamente. Il chiamante deve acquisire un handle esclusivo quando si specifica questo flag o danneggiamento dei dati può verificarsi. Si noti che la piattaforma non convalida l'esclusiva dell'handle.
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
Valore: 0x00000004
Applicabile solo per le directory. Se specificato, contrassegna la directory segnaposto convertita come parzialmente popolata in modo che qualsiasi accesso futuro a esso comporterà un callback FETCH_PLACEHOLDERS inviato al provider di sincronizzazione.
CF_CONVERT_FLAG_ALWAYS_FULL
Valore: 0x00000008
Quando questo flag è presente, il segnaposto appena creato verrà contrassegnato come sempre pieno. Una volta idratato, qualsiasi tentativo di disidratazione di un segnaposto (file) avrà esito negativo con il codice di errore ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED. Questo flag viene applicato solo a un file segnaposto. Può essere impostato su una directory segnaposto, ma non ha alcun effetto.
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
Valore: 0x00000010
Se specificato, la piattaforma consente a un motore di sincronizzazione di convertire atomicamente un segnaposto file non cloud (con un altro tag/dati reparse) in un segnaposto file cloud. Si noti che l'API normalmente non riesce la conversione di qualsiasi file non segnaposto in un segnaposto.

Combinazione **(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE		 CF_CONVERT_FLAG_DEHYDRATE)** è particolarmente utile negli scenari di migrazione quando alcuni provider eseguono la migrazione da un'altra piattaforma a una piattaforma cloud e intendono convertire i segnaposto idratati nella piattaforma precedente in segnaposto disidratati nella piattaforma file cloud atomicamente. Questo flag deve essere passato per convertire i segnaposto completi nei segnaposto del cloud. Se la piattaforma precedente implementa i file completi come file regolari e non segnaposto, questo flag non è necessario. Passando questo flag in una directory converte anche le directory nei file cloud, anche se il flag DEHYDRATE non si applica alle directory.

Anche quando il criterio CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED è stato specificato con CfRegisterSyncRoot, solo i processi registrati/connessi alla radice di sincronizzazione dei file cloud sono autorizzati a specificare questo flag.

>[! NOTA]
>Il flag è supportato solo se l'oggetto PlatformVersion.IntegrationNumber ottenuto da CfGetPlatformInfo è 0x500 o superiore.

Requisiti

   
Client minimo supportato Windows 10 versione 1709 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Intestazione cfapi.h

Vedi anche

CfConvertToPlaceholder

CfRegisterSyncRoot

CfGetPlatformInfo