CF_HYDRATION_POLICY_PRIMARY列挙 (cfapi.h)

  • [アーティクル]

同期プロバイダーが、プラットフォームによってプレースホルダー ファイルをハイドレートする方法を制御できるようにします。 これがプライマリ ポリシーです。

警告

CF_HYDRATION_POLICY_PARTIAL ポリシーは現在サポートされていません。

構文

typedef enum CF_HYDRATION_POLICY_PRIMARY {
  CF_HYDRATION_POLICY_PARTIAL = 0,
  CF_HYDRATION_POLICY_PROGRESSIVE = 1,
  CF_HYDRATION_POLICY_FULL = 2,
  CF_HYDRATION_POLICY_ALWAYS_FULL = 3
} ;

定数

 
CF_HYDRATION_POLICY_PARTIAL
値: 0
CF_HYDRATION_POLICY_PARTIALがバックグラウンドで継続的なハイドレートを持たない点を除き、CF_HYDRATION_POLICY_PROGRESSIVEと同じ動作です。
CF_HYDRATION_POLICY_PROGRESSIVE
値: 1
CF_HYDRATION_POLICY_PROGRESSIVEが選択されている場合、プラットフォームではプレースホルダーを脱水できます。 プラットフォームが脱水プレースホルダーへのアクセスを検出すると、十分なデータが同期プロバイダーから受信されると判断されるとすぐに、ユーザー IO 要求が完了します。 ただし、プレースホルダーの完全なコンテンツがローカルで使用可能になるか、プレースホルダーの最後のユーザー ハンドルが閉じられるまで、プラットフォームはバックグラウンドで同期プロバイダーにプレースホルダー内の残りのコンテンツを要求し続けます。

注
CF_HYDRATION_POLICY_PROGRESSIVEをオプトインする同期プロバイダーは、ハイドレーション コールバックがオフセット 0 から順番に到着するとは想定しない場合があります。 言い換えると、 CF_HYDRATION_POLICY_PROGRESSIVE ポリシーを持つ同期プロバイダーは、プレースホルダーのランダム シークを処理することが期待されます。
CF_HYDRATION_POLICY_FULL
値: 2
CF_HYDRATION_POLICY_FULLが選択されている場合、プラットフォームではプレースホルダーを脱水できます。 プラットフォームが脱水プレースホルダーへのアクセスを検出すると、要求が 1 バイトのみを要求している場合でも、ユーザー IO 要求を完了する前に、プレースホルダーの完全なコンテンツをローカルで使用できるようになります。
CF_HYDRATION_POLICY_ALWAYS_FULL
値: 3
CF_HYDRATION_POLICY_ALWAYS_FULLが選択されている場合、プラットフォームはプレースホルダー操作をブロックします。その結果、完全にハイドレートされないプレースホルダー (CfCreatePlaceholders、脱水オプションを持つ CfUpdatePlaceholder、脱水オプションを使用した CfConvertToPlaceholder など) が含まれます。

要件

   
サポートされている最小のクライアント Windows 10バージョン 1709 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
Header cfapi.h

関連項目

CfCreatePlaceholders

CfUpdatePlaceholder

CfConvertToPlaceholder