StorageProviderHydrationPolicyModifier 列舉

定義

命名空間:

Windows.Storage.Provider

提供要與主要 StorageProviderHydrationPolicy搭配使用的原則修飾詞。

此列舉支援其成員值的位元組合。

public enum class StorageProviderHydrationPolicyModifier

/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Storage.Provider.CloudFilesContract, 65536)]
enum class StorageProviderHydrationPolicyModifier

[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Storage.Provider.CloudFilesContract), 65536)]
public enum StorageProviderHydrationPolicyModifier

var value = Windows.Storage.Provider.StorageProviderHydrationPolicyModifier.none

Public Enum StorageProviderHydrationPolicyModifier

繼承

Enum

StorageProviderHydrationPolicyModifier

屬性

FlagsAttribute ContractVersionAttribute

Windows 需求

裝置系列	Windows Desktop Extension SDK (已於 10.0.16299.0 引進)
API contract	Windows.Storage.Provider.CloudFilesContract (已於 v1.0 引進)

欄位

AllowFullRestartHydration	8	此原則修飾詞會授與平臺許可權，以在攔截 AV 篩選程式嘗試掃描檔案時同步凍結檔案。 想要使用 RestartHydration 從 FetchData Callback 變更 fileSize 的同步提供者，必須加入宣告FULL_RESTART_HYDRATION_REQUIRED ALLOW_FULL_RESTART_HYDRATION原則，以避免使用防毒軟體和防毒軟體嘗試掃描檔案的可能死結，以及嘗試使用 RestartHydration 變更 fileSize 的提供者。
AutoDehydrationAllowed	4	允許自動解除凍結檔案。
None	0	沒有修飾詞。
StreamingAllowed	2	此修飾詞不允許平臺將任何資料儲存在同步提供者所傳回的磁片上。
ValidationRequired	1	一旦資料凍結到檔案中，就會進行驗證。

備註

ValidationRequired 和 StreamingAllowed 是互斥的欄位。

ValidationRequired 為同步提供者提供兩項保證。 首先，它保證同步提供者傳回的資料一律會保存在磁片上，再將它傳回給使用者應用程式;其次，它可讓同步提供者擷取先前傳回給平臺的相同資料，並驗證其完整性。 只有在同步提供者成功確認完整性時，平臺才會完成使用者 IO 要求。 此修飾詞可協助支援端對端資料完整性，但代價是額外的磁片 IO。

StreamingAllowed 會 授與平臺許可權，以不儲存同步提供者在本機磁片上傳回的任何資料。 此原則修飾詞與 ValidationRequired 互斥。 指定兩個旗標時，API 會失敗 並ERROR_INVALID_PARAMETER 。

AutoDehydrationAllowed 會 授與平臺解除凍結同步處理雲端檔案預留位置的許可權，而不需要同步提供者的協助。 如果沒有此旗標，則不允許平臺直接呼叫 CfDehydratePlaceholder。 相反地，解除凍結雲端檔案預留位置的唯一支援方法是清除檔案的釘選屬性，並設定檔案的未釘選屬性，然後在同步處理引擎收到兩個屬性上的目錄變更通知之後，以非同步方式執行實際的解除凍結。 指定此旗標時，平臺將可直接在任何同步處理的雲端檔案預留位置上叫用 CfDehydratePlaceholder 。 建議同步提供者支援自動解除凍結。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1809	17763	AutoDehydrationAllowed