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 回调更改 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