CF_CONVERT_FLAGS列挙 (cfapi.h)

  • [アーティクル]

通常のファイル/ディレクトリからプレースホルダー ファイル/ディレクトリ変換フラグ。

構文

typedef enum CF_CONVERT_FLAGS {
  CF_CONVERT_FLAG_NONE = 0x00000000,
  CF_CONVERT_FLAG_MARK_IN_SYNC = 0x00000001,
  CF_CONVERT_FLAG_DEHYDRATE = 0x00000002,
  CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION = 0x00000004,
  CF_CONVERT_FLAG_ALWAYS_FULL = 0x00000008,
  CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE = 0x00000010
} ;

定数

 
CF_CONVERT_FLAG_NONE
値: 0x00000000
変換フラグはありません。
CF_CONVERT_FLAG_MARK_IN_SYNC
値: 0x00000001
プラットフォームは、ファイルが正常に変換されると、変換されたプレースホルダーをクラウドと同期するようにマークします。
CF_CONVERT_FLAG_DEHYDRATE
値: 0x00000002
ファイルにのみ適用されます。 指定すると、プラットフォームはファイルをプレースホルダーに変換した後、ファイルを正常に退避します。 このフラグを指定する場合、またはデータ破損が発生する可能性がある場合は、呼び出し元が排他的ハンドルを取得する必要があります。 プラットフォームはハンドルの排他的性を検証しないことに注意してください。
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
値: 0x00000004
ディレクトリにのみ適用されます。 指定すると、変換されたプレースホルダー ディレクトリが部分的に設定済みとしてマークされ、将来アクセスすると、同期プロバイダーに送信される FETCH_PLACEHOLDERS コールバックが発生します。
CF_CONVERT_FLAG_ALWAYS_FULL
値: 0x00000008
このフラグが存在する場合、新しく作成されたプレースホルダーは常に完全としてマークされます。 ハイドレートされると、このような (ファイル) プレースホルダーを脱水しようとすると、エラー コード ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWEDで失敗します。 このフラグは、プレースホルダー ファイルにのみ適用されます。 プレースホルダー ディレクトリに設定できますが、効果はありません。
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
値: 0x00000010
このプラットフォームを指定すると、同期エンジンは非クラウド ファイル プレースホルダー (別の再解析タグ/データを持つ) をクラウド ファイル プレースホルダーにアトミックに変換できます。 通常、API はプレースホルダー以外のファイルからプレースホルダーへの変換に失敗します。

組み合わせ **(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE		 CF_CONVERT_FLAG_DEHYDRATE)** は、特定のプロバイダーが別のプラットフォームからクラウド ファイル プラットフォームに移行し、古いプラットフォーム上のハイドレートされたプレースホルダーをクラウド ファイル プラットフォーム上の脱水プレースホルダーにアトミックに変換する場合の移行シナリオで特に便利です。 完全なプレースホルダーをクラウド ファイル プレースホルダーに変換するには、このフラグを渡す必要があります。 古いプラットフォームで完全なファイルが通常のプレースホルダー以外のファイルとして実装されている場合、このフラグは必要ありません。 ディレクトリでこのフラグを渡すと、ディレクトリもクラウド ファイルに変換されますが、 ディレクトリには DEHYDRATE フラグは適用されません。

ポリシー CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED が CfRegisterSyncRoot で指定された場合でも、クラウド ファイル同期ルートに登録または接続されているプロセスのみがこのフラグを指定できます。

>[!注]
>フラグは、CfGetPlatformInfo から取得した PlatformVersion.IntegrationNumber が以上の0x500場合にのみサポートされます。

要件

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

関連項目

CfConvertToPlaceholder

CfRegisterSyncRoot

CfGetPlatformInfo