CfGetPlaceholderStateFromAttributeTag 函数 (cfapi.h)
根据文件的 FileAttributes 和 ReparseTag 值获取一组占位符状态。
语法
CF_PLACEHOLDER_STATE CfGetPlaceholderStateFromAttributeTag(
[in] DWORD FileAttributes,
[in] DWORD ReparseTag
);
参数
[in] FileAttributes
文件属性信息。
[in] ReparseTag
重新分析文件中的标记信息。
返回值
可以包括 CF_PLACEHOLDER_STATE;占位符状态。
注解
可以通过列出包含文件的目录或直接查询文件上的 FileAttributeTagInfo 来获取 FileAttributeTag 和 ReparseTag。
可以返回以下 CF_PLACEHOLDER_STATE 值：
|占位符状态 |说明 | | CF_PLACEHOLDER_STATE_NO_STATES |返回时，API 检查其属性和重新分析标记的文件或目录不是云文件占位符。 | | CF_PLACEHOLDER_STATE_PLACEHOLDER |设置后，由 API 检查其属性和重新分析标记的文件或目录是云文件占位符。 | | CF_PLACEHOLDER_STATE_SYNC_ROOT |设置后，目录不仅是云文件占位符目录，也是同步根目录。 | | CF_PLACEHOLDER_STATE_ESSENTIAL_PROP_PRESENT |设置后，文件或目录必须是云文件占位符，并且文件或目录的属性存储中存在基本属性。 | | CF_PLACEHOLDER_STATE_IN_SYNC |设置后，文件或目录必须是云文件占位符，并且其内容与云同步。 | | CF_PLACEHOLDER_STATE_PARTIAL |设置后，文件或目录必须是云文件占位符，并且其内容尚未准备好供用户应用程序使用， (尽管它可能或可能不会完全呈现在本地) 。 例如，占位符文件的内容已完全下载到本地磁盘，但尚未由已使用 hydration 修饰符 VERIFICATION_REQUIRED注册同步根的同步提供程序进行验证。 | | CF_PLACEHOLDER_STATE_PARTIALLY_ON_DISK |设置后，文件或目录必须是云文件占位符，并且其内容在本地未完全显示。 设置 PARTIALLY_ON_DISK 时，还必须设置 PARTIAL 。 | | CF_PLACEHOLDER_STATE_INVALID |当 API 无法分析文件或目录的各种信息时，这是无效状态。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10版本 1709 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | cfapi.h |
| Library | CldApi.lib |
| DLL | CldApi.dll |