CF_HYDRATION_POLICY_MODIFIER列舉 (cfapi.h)
允許同步提供者控制平臺應如何凍結佔位符檔案。 這是可與主要原則搭配使用的修飾詞： CF_HYDRATION_POLICY_PRIMARY。
Syntax
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
} ;
常數
CF_HYDRATION_POLICY_MODIFIER_NONE0x0000沒有原則修飾詞。 |
CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED0x0001此原則修飾詞可為同步提供者提供兩項保證。 首先，它保證同步提供者傳回的數據一律會保存在磁碟上，再將它傳回給用戶應用程式。 其次，它可讓同步提供者擷取先前傳回給平臺的相同數據，並驗證其完整性。 只有在同步提供者成功確認完整性時，平臺才會完成使用者 I/O 要求。 此修飾詞可協助支援端對端數據完整性，代價是額外的磁碟 I/O。 |
CF_HYDRATION_POLICY_MODIFIER_STREAMING_ALLOWED0x0002此原則修飾詞會授與平台許可權，以不儲存同步提供者在本機磁碟上傳回的任何數據。 與 CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED結合時，此原則修飾詞無效。 |
CF_HYDRATION_POLICY_MODIFIER_AUTO_DEHYDRATION_ALLOWED0x0004此原則修飾詞會授與平臺解除凍結同步處理雲端檔案佔位符的許可權，而不需要同步提供者的協助。 如果沒有此旗標，則不允許平臺直接呼叫 CfDehydratePlaceholder 。 相反地，解除凍結雲端檔案佔位符的唯一支援方式是清除檔案的釘選屬性，並設定檔案的未釘選屬性。 此時，同步處理引擎會在收到兩個屬性上的目錄變更通知之後，以異步方式執行實際的解除凍結。 指定此旗標時，平臺將可直接在任何同步處理的雲端檔案佔位符上叫用 CfDehydratePlaceholder 。 建議同步提供者支持自動解除凍結。 注意 此值可在 Windows 10 1803 版和更新版本中使用。 |
CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION0x0008此原則修飾詞會授與平台許可權，以在攔截AV篩選程式嘗試掃描檔案時同步凍結檔案。 想要使用 RestartHydration 從 FetchData 回呼變更 fileSize 的同步提供者，必須選擇加入原則ALLOW_FULL_RESTART_HYDRATION，以避免使用防病毒軟體和防病毒軟體嘗試掃描檔案的可能死結，以及嘗試使用 RestartHydration 進行變更fileSize的提供者。注意 只有當從 CfGetPlatformInfo 取得的 為 |
備註
一般而言，修飾詞可以混合並與任何主要原則 (CF_HYDRATION_POLICY_PRIMARY) 和其他 原則修飾詞進行比對，只要組合不是自我衝突。
系統會新增 旗 CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION 標，以避免重新啟動凍結功能遇到防病毒軟體和惡意代碼偵測器 (防病毒軟體) 所造成的死結。 所有想要在凍結要求期間更新已解除凍結檔案檔案大小的同步提供者，都應該選擇加入此功能，或在AV嘗試掃描檔案開啟的檔案時重新啟動凍結可能會發生死結，方法是建立檔案的記憶體對應區段並導致凍結。 請注意，維護檔案快照集或版本的提供者，並提供要求版本的檔案，以滿足使用者的要求，即使後端/伺服器中已更新檔案，也不需要選擇加入此原則。 同樣地，如果後端中的檔案已變更，則失敗凍結要求的提供者可能不會選擇加入此原則。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 1709 版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 標頭 | cfapi.h |