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 无法分析文件或目录的信息时，这是无效状态。

注解

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

要求

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

另请参阅

CfGetPlaceholderStateFromAttributeTag

CfGetPlaceholderStateFromFileInfo

CfGetPlaceholderStateFromFindData