enumerasi CF_HYDRATION_POLICY_MODIFIER (cfapi.h)

2023-03-08

Memungkinkan penyedia sinkronisasi untuk mengontrol bagaimana file tempat penampung harus dihidrasi oleh platform. Ini adalah pengubah yang dapat digunakan dengan kebijakan utama: CF_HYDRATION_POLICY_PRIMARY.

Sintaks

typedef enum CF_HYDRATION_POLICY_MODIFIER {
  CF_HYDRATION_POLICY_MODIFIER_NONE,
  CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED,
  CF_HYDRATION_POLICY_MODIFIER_STREAMING_ALLOWED,
  CF_HYDRATION_POLICY_MODIFIER_AUTO_DEHYDRATION_ALLOWED,
  CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION
} ;

Konstanta


`CF_HYDRATION_POLICY_MODIFIER_NONE` `0x0000` Tidak ada pengubah kebijakan.
`CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED` `0x0001` Pengubah kebijakan ini menawarkan dua jaminan kepada penyedia sinkronisasi. Pertama, ini menjamin bahwa data yang dikembalikan oleh penyedia sinkronisasi selalu disimpan ke disk sebelum dikembalikan ke aplikasi pengguna. Kedua, ini memungkinkan penyedia sinkronisasi untuk mengambil data yang sama yang telah dikembalikan sebelumnya ke platform dan memvalidasi integritasnya. Hanya setelah konfirmasi integritas yang berhasil oleh penyedia sinkronisasi, platform akan menyelesaikan permintaan I/O pengguna. Pengubah ini membantu mendukung integritas data end-to-end dengan biaya I/Os disk tambahan.
`CF_HYDRATION_POLICY_MODIFIER_STREAMING_ALLOWED` `0x0002` Pengubah kebijakan ini memberi platform izin untuk tidak menyimpan data apa pun yang dikembalikan oleh penyedia sinkronisasi pada disk lokal. Pengubah kebijakan ini tidak efektif ketika digabungkan dengan CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED.
`CF_HYDRATION_POLICY_MODIFIER_AUTO_DEHYDRATION_ALLOWED` `0x0004` Pengubah kebijakan ini memberi platform izin untuk mendehidrasi tempat penampung file cloud dalam sinkronisasi tanpa bantuan penyedia sinkronisasi. Tanpa bendera ini, platform tidak diizinkan untuk memanggil CfDehydratePlaceholder secara langsung. Sebaliknya, satu-satunya cara yang didukung untuk mendehidrasi tempat penampung file cloud adalah dengan menghapus atribut file yang disematkan dan mengatur atribut file yang tidak disematkan. Pada saat itu, dehidrasi aktual akan dilakukan secara asinkron oleh mesin sinkronisasi setelah menerima pemberitahuan perubahan direktori pada dua atribut. Ketika bendera ini ditentukan, platform akan diizinkan untuk memanggil CfDehydratePlaceholder langsung di tempat penampung file cloud dalam sinkronisasi. Disarankan bagi penyedia sinkronisasi untuk mendukung dehidrasi otomatis. CATATAN Nilai ini tersedia di Windows 10, versi 1803 dan yang lebih baru.
`CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION` `0x0008` Pengubah kebijakan ini memberikan izin platform untuk sepenuhnya menghidrasi file secara sinkron ketika mencegat upaya oleh Filter AV untuk memindai file. Penyedia sinkronisasi yang ingin menggunakan RestartHydration untuk mengubah `fileSize` dari panggilan balik FetchData harus ikut serta dalam `ALLOW_FULL_RESTART_HYDRATION` kebijakan untuk menghindari kemungkinan kebuntuan dengan perangkat lunak anti-virus dan anti-malware yang mencoba memindai file dan penyedia mencoba mengubah `fileSize` menggunakan RestartHydration. CATATAN Pembaruan enum ini hanya didukung jika `PlatformVersion.IntegrationNumber` diperoleh dari CfGetPlatformInfo`0x500` atau lebih tinggi.

Keterangan

Secara umum, pengubah dapat dicampur dan dicocokkan dengan kebijakan utama (CF_HYDRATION_POLICY_PRIMARY) dan pengubah kebijakan lainnya selama kombinasi tidak bertentangan dengan diri sendiri.

CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION Bendera ditambahkan untuk menghindari fitur Hidupkan Ulang Hidrasi dari menemukan kebuntuan yang disebabkan oleh pendeteksi Anti-Virus dan Malware (AV). Semua Penyedia Sinkronisasi yang ingin memperbarui ukuran file file yang dehidrasi selama permintaan hidrasi harus ikut serta untuk fitur ini atau menghidrasi ulang hidrasi dapat mengalami kebuntuan ketika AV mencoba memindai file yang dibuka dengan membuat bagian file yang dipetakan memori dan yang menyebabkan hidrasi. Perhatikan bahwa penyedia yang mempertahankan rekam jepret atau versi file dan memenuhi permintaan pengguna dengan menyediakan versi file yang diminta meskipun file telah diperbarui di backend/server tidak perlu ikut serta untuk kebijakan ini. Demikian pula, penyedia yang gagal dalam permintaan hidrasi jika file telah berubah di backend mungkin tidak ikut serta untuk kebijakan ini.

Persyaratan

Persyaratan	Nilai
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

CF_HYDRATION_POLICY_PRIMARY

CfDehydratePlaceholder

CfGetPlatformInfo

Bagikan melalui