占位符文件或文件夹的状态。
语法
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