CF_PLACEHOLDER_STATE 枚举 (cfapi.h)

占位符文件或文件夹的状态。

语法

typedef enum CF_PLACEHOLDER_STATE {
  CF_PLACEHOLDER_STATE_NO_STATES = 0x00000000,
  CF_PLACEHOLDER_STATE_PLACEHOLDER = 0x00000001,
  CF_PLACEHOLDER_STATE_SYNC_ROOT = 0x00000002,
  CF_PLACEHOLDER_STATE_ESSENTIAL_PROP_PRESENT = 0x00000004,
  CF_PLACEHOLDER_STATE_IN_SYNC = 0x00000008,
  CF_PLACEHOLDER_STATE_PARTIAL = 0x00000010,
  CF_PLACEHOLDER_STATE_PARTIALLY_ON_DISK = 0x00000020,
  CF_PLACEHOLDER_STATE_INVALID = 0xffffffff
} ;

常量

CF_PLACEHOLDER_STATE_NO_STATES 值： 0x00000000 返回时，API 检查其 FileAttributes 和 ReparseTag 的文件或目录不是占位符。
CF_PLACEHOLDER_STATE_PLACEHOLDER 值： 0x00000001 由 API 检查其 FileAttributes 和 ReparseTag 的文件或目录是占位符。
CF_PLACEHOLDER_STATE_SYNC_ROOT 值： 0x00000002 目录既是占位符目录，也是同步根目录。
CF_PLACEHOLDER_STATE_ESSENTIAL_PROP_PRESENT 值： 0x00000004 文件或目录必须是占位符，并且文件或目录的属性存储中存在基本属性。
CF_PLACEHOLDER_STATE_IN_SYNC 值： 0x00000008 文件或目录必须是占位符，其内容必须与云同步。
CF_PLACEHOLDER_STATE_PARTIAL 值： 0x00000010 文件或目录必须是占位符，并且其内容尚未准备好供用户应用程序使用，尽管它可能在本地完全存在，也可能不完全存在。 例如，占位符文件的内容已完全下载到本地磁盘，但尚未由已使用 hydration 修饰符 VERIFICATION_REQUIRED注册同步根的同步提供程序进行验证。
CF_PLACEHOLDER_STATE_PARTIALLY_ON_DISK 值： 0x00000020 文件或目录必须是占位符，并且其内容在本地未完全存在。 设置此项后，还必须设置 CF_PLACEHOLDER_STATE_PARTIAL 。
CF_PLACEHOLDER_STATE_INVALID 值： 0xffffffff 当 API 无法分析文件或目录的信息时，这是无效状态。

注解

可以通过调用以下函数来获取占位符状态信息：

• CfGetPlaceholderStateFromAttributeTag
• CfGetPlaceholderStateFromFileInfo
• CfGetPlaceholderStateFromFindData

要求

要求	值
最低受支持的客户端	Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
标头	cfapi.h

另请参阅

CfGetPlaceholderStateFromAttributeTag

CfGetPlaceholderStateFromFileInfo

CfGetPlaceholderStateFromFindData