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，并且平台将在成功更新调用后删除占位符上的现有文件标识 blob。
CF_UPDATE_FLAG_CLEAR_IN_SYNC 0x00000040 成功执行更新占位符操作后，平台会将占位符标记为未同步。
CF_UPDATE_FLAG_REMOVE_PROPERTY 0x00000080 平台删除占位符上的所有现有外部属性。 注意 此值在 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 [仅限桌面应用]
标头	cfapi.h

另请参阅

CfUpdatePlaceholder