Bagikan melalui

enumerasi CF_CONVERT_FLAGS (cfapi.h)

  • Artikel

File/direktori normal untuk menempatkan bendera konversi file/direktori.

Sintaks

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

Konstanta

 
CF_CONVERT_FLAG_NONE
Nilai: 0x00000000
Tidak ada bendera konversi.
CF_CONVERT_FLAG_MARK_IN_SYNC
Nilai: 0x00000001
Platform menandai tempat penampung yang dikonversi sebagai sinkron dengan cloud setelah konversi file berhasil.
CF_CONVERT_FLAG_DEHYDRATE
Nilai: 0x00000002
Hanya berlaku untuk file. Ketika ditentukan, platform melakukan dehidrasi file setelah berhasil mengonversinya menjadi tempat penampung. Pemanggil harus memperoleh handel eksklusif saat menentukan bendera atau kerusakan data ini dapat terjadi. Perhatikan bahwa platform tidak memvalidasi kerahasiaan handel.
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
Nilai: 0x00000004
Hanya berlaku untuk direktori. Ketika ditentukan, ini menandai direktori tempat penampung yang dikonversi sebagai sebagian diisi sehingga akses mendatang ke direktori tersebut akan menghasilkan panggilan balik FETCH_PLACEHOLDERS yang dikirim ke penyedia sinkronisasi.
CF_CONVERT_FLAG_ALWAYS_FULL
Nilai: 0x00000008
Ketika bendera ini ada, tempat penampung yang baru dibuat akan ditandai sebagai selalu penuh. Setelah terhidrasi, setiap upaya untuk mendehidrasi tempat penampung (file) seperti itu akan gagal dengan kode kesalahan ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED. Bendera ini diberlakukan hanya pada file tempat penampung. Ini dapat diatur pada direktori tempat penampung, tetapi tidak berpengaruh.
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
Nilai: 0x00000010
Ketika ditentukan, platform memungkinkan mesin sinkronisasi untuk mengonversi tempat penampung file non-cloud secara atomik (memiliki tag/data reparse lain) ke tempat penampung file cloud. Perhatikan bahwa API biasanya gagal meng-konversi file non-tempat penampung ke tempat penampung.

Kombinasi **(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE		 CF_CONVERT_FLAG_DEHYDRATE)** sangat berguna dalam skenario migrasi ketika penyedia tertentu bermigrasi dari platform lain ke platform file cloud dan mereka berniat untuk mengonversi tempat penampung terhidrasi pada platform yang lebih lama menjadi tempat penampung dehidrasi pada platform file cloud secara atomik. Hanya bendera ini yang harus diteruskan untuk mengonversi tempat penampung penuh ke tempat penampung file cloud. Jika platform lama mengimplementasikan file lengkap sebagai file reguler dan non-tempat penampung, bendera ini tidak diperlukan. Meneruskan bendera ini pada direktori juga mengonversi direktori ke file cloud, meskipun bendera DEHYDRATE tidak berlaku untuk direktori.

Bahkan ketika CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED kebijakan ditentukan dengan CfRegisterSyncRoot, hanya proses yang telah mendaftar/terhubung ke akar sinkronisasi file cloud yang diizinkan untuk menentukan bendera ini.

>[! CATATAN]
>Bendera hanya didukung jika yang PlatformVersion.IntegrationNumber diperoleh dari CfGetPlatformInfo adalah 0x500 atau lebih tinggi.

Persyaratan

   
Klien minimum yang didukung Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2016 [hanya aplikasi desktop]
Header cfapi.h

Lihat juga

CfConvertToPlaceholder

CfRegisterSyncRoot

CfGetPlatformInfo