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

另请参阅

CF_PLACEHOLDER_STATE