CF_UPDATE_FLAGS列挙 (cfapi.h)

  • [アーティクル]

プレースホルダー ファイルまたはディレクトリを更新するためのフラグ。

構文

typedef enum CF_UPDATE_FLAGS {
  CF_UPDATE_FLAG_NONE,
  CF_UPDATE_FLAG_VERIFY_IN_SYNC,
  CF_UPDATE_FLAG_MARK_IN_SYNC,
  CF_UPDATE_FLAG_DEHYDRATE,
  CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY,
  CF_UPDATE_FLAG_CLEAR_IN_SYNC,
  CF_UPDATE_FLAG_REMOVE_PROPERTY,
  CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA,
  CF_UPDATE_FLAG_ALWAYS_FULL,
  CF_UPDATE_FLAG_ALLOW_PARTIAL
} ;

定数

 
CF_UPDATE_FLAG_NONE
0x00000000

更新フラグはありません。
CF_UPDATE_FLAG_VERIFY_IN_SYNC
0x00000001

CF_UPDATE_FLAG_MARK_IN_SYNC属性がプレースホルダーに現在設定されていない場合、更新は失敗します。 これは、クラウドからローカル プレースホルダーへの変更の同期と、プレースホルダーのデータ ストリームがローカルに変更されるのを防ぐためです。
CF_UPDATE_FLAG_MARK_IN_SYNC
0x00000002

プラットフォームでは、更新プレースホルダー操作が成功すると、プレースホルダーが同期中としてマークされます。
CF_UPDATE_FLAG_DEHYDRATE
0x00000004

ファイルにのみ適用されます。 指定すると、プラットフォームはプレースホルダーを正常に更新した後にファイルを退避します。 このフラグを指定する場合、またはデータの破損が発生する可能性がある場合は、呼び出し元が排他的ハンドルを取得する必要があります。 プラットフォームでは、ハンドルの排他性は検証されないことに注意してください。
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION
0x00000008

ディレクトリにのみ適用されます。 指定すると、更新されたプレースホルダー ディレクトリが部分的に設定され、そのディレクトリに今後アクセスすると、同期プロバイダーにFETCH_PLACEHOLDERSコールバックが送信されます。
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION
0x00000010

ディレクトリにのみ適用されます。 指定すると、更新されたプレースホルダー ディレクトリが完全に設定され、そのディレクトリへの今後のアクセスが、同期プロバイダーへのコールバックなしでプラットフォームによって処理されるようにマークされます。
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY
0x00000020

指定すると、CfUpdatePlaceholder の FileIdentity と FileIdentityLength は無視され、更新呼び出しが成功すると、プラットフォームによってプレースホルダーの既存のファイル ID BLOB が削除されます。
CF_UPDATE_FLAG_CLEAR_IN_SYNC
0x00000040

プラットフォームでは、更新プレースホルダー操作が正常に行われると、プレースホルダーが同期していないとマークされます。
CF_UPDATE_FLAG_REMOVE_PROPERTY
0x00000080

プラットフォームは、プレースホルダーの既存の extrinsic プロパティをすべて削除します。

注

この値は、Windows 10 バージョン 1803 以降で使用できます。
CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA
0x00000100

プラットフォームは、フィルター処理を行わずに CF_FS_METADATA をファイル システムに渡します。それ以外の場合、プラットフォームは値が 0 のフィールドの設定をスキップします。

注

この値は、Windows 10 バージョン 1803 以降で使用できます。
CF_UPDATE_FLAG_ALWAYS_FULL
0x00000200

CF_UPDATE_FLAG_ALWAYS_FULL はプレースホルダー ファイルでのみ有効です。 指定すると、更新するプレースホルダーは常に完全としてマークされます。 ハイドレートされると、このようなプレースホルダー ファイルを退避しようとすると、エラー コード ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWEDで失敗します。
CF_UPDATE_FLAG_ALLOW_PARTIAL
0x00000400

CF_UPDATE_FLAG_ALLOW_PARTIAL はプレースホルダー ファイルでのみ有効です。 指定すると、プレースホルダー ファイルの常に完全な状態 (存在する場合) がクリアされるため、再び退避できます。 このフラグを と CF_UPDATE_FLAG_ALWAYS_FULL 共に指定することは無効であり、結果としてエラー コード ERROR_CLOUD_FILE_INVALID_REQUEST が返されます。

要件

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

こちらもご覧ください

CfUpdatePlaceholder