Bearbeiten

CF_CONVERT_FLAGS enumeration (cfapi.h)

  • Artikel
  • 2 Minuten Lesedauer

Normal file/directory to placeholder file/directory conversion flags.

Syntax

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

Constants

 
CF_CONVERT_FLAG_NONE
Value: 0x00000000
No conversion flags.
CF_CONVERT_FLAG_MARK_IN_SYNC
Value: 0x00000001
The platform marks the converted placeholder as in sync with cloud upon a successful conversion of the file.
CF_CONVERT_FLAG_DEHYDRATE
Value: 0x00000002
Applicable to files only. When specified, the platform dehydrates the file after converting it to a placeholder successfully. The caller must acquire an exclusive handle when specifying this flag or data corruptions can occur. Note that the platform does not validate the exclusiveness of the handle.
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
Value: 0x00000004
Applicable for directories only. When specified, it marks the converted placeholder directory as partially populated such that any future access to it will result in a FETCH_PLACEHOLDERS callback sent to the sync provider.
CF_CONVERT_FLAG_ALWAYS_FULL
Value: 0x00000008
When this flag is present, the newly created placeholder will be marked as always full. Once hydrated, any attempt to dehydrate such a (file) placeholder will fail with error code ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED. This flag is enforced on a placeholder file only. It can be set on a placeholder directory, but it has no effect.
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
Value: 0x00000010
When specified, the platform allows a sync engine to atomically convert a non-cloud files placeholder (having another reparse tag/data) to a cloud files placeholder. Note that the API normally fails conversion of any non-placeholder file to a placeholder.

Requirements

   
Minimum supported client Windows 10, version 1709 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Header cfapi.h