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 を使用して fileSize を FetchData コールバックから変更する同期プロバイダーは、ファイルをスキャンしようとしているウイルス対策およびマルウェア対策ソフトウェアと、RestartHydration を使用して fileSize を変更しようとしているプロバイダーで発生する可能性のあるデッドロックを回避するために、FULL_RESTART_HYDRATION_REQUIRED ALLOW_FULL_RESTART_HYDRATION ポリシーをオプトインする必要があります。
AutoDehydrationAllowed	4	自動ファイル脱水が可能です。
None	0	なし
StreamingAllowed	2	この修飾子は、プラットフォームが同期プロバイダーによって返されたディスクにデータを格納することを許可しません。
ValidationRequired	1	データがファイルにハイドレートされると、検証されます。

注釈

ValidationRequired フィールドと StreamingAllowed フィールドは相互に排他的です。

ValidationRequired では、同期プロバイダーに 2 つの保証が提供されます。 最初に、同期プロバイダーによって返されたデータが、ユーザー アプリケーションに返される前に常にディスクに保持されることを保証します。2 つ目は、同期プロバイダーが以前にプラットフォームに返したのと同じデータを取得し、その整合性を検証できるようにします。 同期プロバイダーによる整合性の確認が成功した場合にのみ、プラットフォームはユーザー IO 要求を完了します。 この修飾子は、余分なディスク IO を犠牲にして、エンドツーエンドのデータ整合性をサポートするのに役立ちます。

StreamingAllowed は 、同期プロバイダーによって返されたデータをローカル ディスクに格納しないアクセス許可をプラットフォームに付与します。 このポリシー修飾子は、ValidationRequired と相互に排他的です。 両方のフラグが指定されている場合、 API は ERROR_INVALID_PARAMETER で失敗します。

AutoDehydrationAllowed は、同期プロバイダーの助けを借りずに、同期中のクラウド ファイル プレースホルダーを退避するアクセス許可をプラットフォームに付与します。 このフラグがないと、プラットフォームは CfDehydratePlaceholder を直接呼び出すことはできません。 代わりに、クラウド ファイル プレースホルダーを退避する唯一の方法は、ファイルのピン留めされた属性をクリアし、ファイルのピン留めされていない属性を設定し、2 つの属性のディレクトリ変更通知を受信した後、同期エンジンによって実際の退避が非同期的に実行されることです。 このフラグを指定すると、プラットフォームは、同期中のクラウド ファイル プレースホルダーで CfDehydratePlaceholder を直接呼び出すことができます。 同期プロバイダーは、自動脱水をサポートすることをお勧めします。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1809	17763	AutoDehydrationAllowed