cfapi.h 标头

此标头由云筛选器 API 使用。 有关详细信息，请参见:

• 云筛选器 API

cfapi.h 包含以下编程接口：

Functions

CfCloseHandle 关闭 CfOpenFileWithOplock 返回的文件或目录句柄。 这不应与标准 Win32 文件句柄一起使用，仅适用于 CfApi.h 中使用的句柄。
CfConnectSyncRoot 在同步提供程序和同步筛选器 API 之间启动双向通信。
CfConvertToPlaceholder 将普通文件/目录转换为占位符文件/目录。
CfCreatePlaceholders 在同步根树下创建一个或多个新的占位符文件或目录。
CfDisconnectSyncRoot 断开 CfConnectSyncRoot 创建的信道的连接。
CfExecute 所有基于连接键的占位符作的主要入口点。 它旨在由同步提供程序用来响应来自平台的各种回调。
CfGetCorrelationVector 允许同步提供程序查询给定占位符文件的当前关联向量。
CfGetPlaceholderInfo 获取占位符文件或文件夹的各种特征。
CfGetPlaceholderRangeInfo 获取有关占位符文件或文件夹的范围信息。
CfGetPlaceholderRangeInfoForHydration 获取有关使用 ConnectionKey、TransferKey 和 FileId 作为标识符的占位符文件或文件夹的范围信息。
CfGetPlaceholderStateFromAttributeTag 根据文件的 FileAttributes 和 ReparseTag 值获取一组占位符状态。
CfGetPlaceholderStateFromFileInfo 根据文件的各种信息获取一组占位符状态。
CfGetPlaceholderStateFromFindData 根据WIN32_FIND_DATA结构获取一组占位符状态。
CfGetPlatformInfo 获取平台版本信息。
CfGetSyncRootInfoByHandle 获取包含由文件句柄指定的给定文件的同步根的各种特征。
CfGetSyncRootInfoByPath 获取给定同步根目录下文件的各种同步根信息。
CfGetTransferKey 启动将数据传输到占位符文件或文件夹。
CfGetWin32HandleFromProtectedHandle 将受保护的句柄转换为 Win32 句柄，以便它可以用于所有基于句柄的 Win32 API。
CfHydratePlaceholder 通过确保占位符中的磁盘上存在指定的字节范围来冻结占位符文件。 这仅适用于文件。
CfOpenFileWithOplock 打开文件或目录（对于普通文件和占位符文件）的异步不透明句柄，并根据打开的标志设置适当的作锁。
CfQuerySyncProviderStatus 查询同步提供程序以获取提供程序的状态。
CfReferenceProtectedHandle 允许调用方将受保护的句柄引用到 Win32 句柄，该句柄可用于非 CfApi Win32 API。
CfRegisterSyncRoot 执行一次性同步根注册。
CfReleaseProtectedHandle 释放 CfReferenceProtectedHandle 引用的受保护句柄。
CfReleaseTransferKey 释放 CfGetTransferKey 获取的传输密钥。
CfReportProviderProgress 允许同步提供程序报告带外进度。
CfReportProviderProgress2 允许同步提供程序报告带外进度。 使用其他参数扩展 CfReportProviderProgress。
CfReportSyncStatus 允许同步提供程序在指定的同步根上通知平台其状态，而无需先连接到 CfConnectSyncRoot 的调用。
CfRevertPlaceholder 将占位符还原回常规文件，去除所有特殊特征，例如重新分析标记、文件标识等。
CfSetCorrelationVector 允许同步提供程序指示平台对占位符文件使用特定的关联向量进行遥测。 这是可选的。
CfSetInSyncState 设置占位符文件或文件夹的同步状态。
CfSetPinState 此函数设置占位符的引脚状态，该状态表示用户的意图。 任何应用程序（而不仅仅是同步提供程序）都可以调用此函数。
CfUnregisterSyncRoot 取消注册以前注册的同步根目录。
CfUpdatePlaceholder 更新占位符文件或目录的特征。
CfUpdateSyncProviderStatus 更新同步提供程序的当前状态。

结构

CF_CALLBACK_INFO 包含常见的回调信息。
CF_CALLBACK_PARAMETERS 包含回调特定的参数，例如文件偏移量、长度、标志等。
CF_CALLBACK_REGISTRATION 同步提供程序要注册的回调。
CF_FILE_RANGE 指定占位符文件中的一系列数据。
CF_FS_METADATA 占位符文件或目录元数据。
CF_HYDRATION_POLICY 指定主要冻结策略及其修饰符。
CF_OPERATION_INFO 有关占位符文件或文件夹的作的信息。
CF_OPERATION_PARAMETERS 占位符文件或文件夹的作的参数。
CF_PLACEHOLDER_BASIC_INFO 基本占位符信息。
CF_PLACEHOLDER_CREATE_INFO 包含用于创建新占位符文件或目录的占位符信息。
CF_PLACEHOLDER_STANDARD_INFO 标准占位符信息。
CF_PLATFORM_INFO 返回云文件平台的信息。 这适用于在多个版本的 Windows 上运行的同步提供程序。
CF_POPULATION_POLICY 指定主要填充策略及其修饰符。
CF_PROCESS_INFO 包含有关用户进程的信息。
CF_SYNC_POLICIES 定义同步根使用的同步策略。
CF_SYNC_REGISTRATION 要注册的同步提供程序和同步根的详细信息。
CF_SYNC_ROOT_BASIC_INFO 基本同步根信息。
CF_SYNC_ROOT_PROVIDER_INFO 同步根提供程序信息。
CF_SYNC_ROOT_STANDARD_INFO 标准同步根信息。
CF_SYNC_STATUS 在CF_OPERATION_INFO结构中用于描述指定同步根的状态。

枚举

CF_CALLBACK_CANCEL_FLAGS 用于取消占位符文件或文件夹的数据提取的回调标志。
CF_CALLBACK_CLOSE_COMPLETION_FLAGS 用于通知同步提供程序的回调标志，其同步根下的占位符（以前已打开进行读/写/删除访问）现已关闭。
CF_CALLBACK_DEHYDRATE_COMPLETION_FLAGS 用于通知同步提供程序的一个同步根下的占位符已成功解除冻结的回调标志。
CF_CALLBACK_DEHYDRATE_FLAGS 用于通知同步提供程序在其一个同步根下的占位符将解除冻结的回调标志。
CF_CALLBACK_DEHYDRATION_REASON 指定解除冻结云文件的原因。
CF_CALLBACK_DELETE_COMPLETION_FLAGS 用于通知同步提供程序已成功删除占位符的回调标志。
CF_CALLBACK_DELETE_FLAGS 此回调用于通知同步提供程序，其中一个同步根下的占位符文件或目录即将被删除或取消删除。
CF_CALLBACK_FETCH_DATA_FLAGS 用于提取占位符文件或文件夹数据的回调标志。
CF_CALLBACK_FETCH_PLACEHOLDERS_FLAGS 用于获取有关占位符文件或目录内容的信息的标志。
CF_CALLBACK_OPEN_COMPLETION_FLAGS 用于通知同步提供程序已成功打开占位符进行读/写/删除访问的回调标志。
CF_CALLBACK_RENAME_COMPLETION_FLAGS 用于通知同步提供程序的回调标志，其中一个同步根下的占位符已成功重命名。
CF_CALLBACK_RENAME_FLAGS 回叫标志以通知同步提供程序在其一个同步根下的占位符即将重命名或移动。
CF_CALLBACK_TYPE 包含占位符文件或文件夹上使用的各种回调。
CF_CALLBACK_VALIDATE_DATA_FLAGS 用于验证占位符文件或目录的数据的标志。
CF_CONNECT_FLAGS 调用同步提供程序时可以请求的其他信息。
CF_CONVERT_FLAGS 普通文件/目录到占位符文件/目录转换标志。
CF_CREATE_FLAGS 用于创建占位符文件或目录的标志。
CF_DEHYDRATE_FLAGS 占位符解除冻结标志。
CF_HARDLINK_POLICY 指定是否允许在占位符文件上使用硬链接。
CF_HYDRATE_FLAGS 占位符数据冻结标志。
CF_HYDRATION_POLICY_MODIFIER 允许同步提供程序控制占位符文件应如何由平台冻结。 这是可与主策略：_CF_HYDRATION_POLICY_PRIMARY一起使用的修饰符。
CF_HYDRATION_POLICY_PRIMARY 允许同步提供程序控制占位符文件应如何由平台冻结。 这是主要策略。
CF_IN_SYNC_STATE 指定占位符文件和文件夹的同步状态。
CF_INSYNC_POLICY 允许同步提供程序控制平台何时应清除占位符文件或目录上的同步状态的策略。
CF_OPEN_FILE_FLAGS 用于请求打开文件的各种权限的标志。
CF_OPERATION_ACK_DATA_FLAGS 用于验证和确认占位符文件或文件夹的数据的标志。
CF_OPERATION_ACK_DEHYDRATE_FLAGS 用于确认占位符文件或目录解除冻结的标志。
CF_OPERATION_ACK_DELETE_FLAGS 用于确认删除占位符文件或目录的标志。
CF_OPERATION_ACK_RENAME_FLAGS 用于确认占位符文件或目录重命名的标志。
CF_OPERATION_RESTART_HYDRATION_FLAGS 用于在占位符文件或文件夹上重启数据冻结的标志。
CF_OPERATION_RETRIEVE_DATA_FLAGS 用于检索占位符文件或文件夹的数据的标志。
CF_OPERATION_TRANSFER_DATA_FLAGS 用于将数据传输到占位符文件或文件夹的标志。
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS 用于指定传输占位符文件或目录时的行为的标志。
CF_OPERATION_TYPE 可在占位符文件和目录上执行的作类型。
CF_PIN_STATE 占位符文件或目录的固定状态。
CF_PLACEHOLDER_CREATE_FLAGS 用于基于每个占位符创建占位符的标志。
CF_PLACEHOLDER_INFO_CLASS 占位符信息的信息类。
CF_PLACEHOLDER_MANAGEMENT_POLICY 指定CF_SYNC_POLICIES结构的占位符管理策略。
CF_PLACEHOLDER_RANGE_INFO_CLASS 占位符文件数据范围的类型。
CF_PLACEHOLDER_STATE 占位符文件或文件夹的状态。
CF_POPULATION_POLICY_MODIFIER 定义总体策略修饰符。 这是可与主策略：_CF_POPULATION_POLICY_PRIMARY一起使用的修饰符。
CF_POPULATION_POLICY_PRIMARY 允许同步提供程序控制平台应如何创建占位符目录和文件。 这是主要策略。
CF_REGISTER_FLAGS 用于注册和更新同步根的标志。
CF_REVERT_FLAGS 用于将占位符文件还原为常规文件的标志。
CF_SET_IN_SYNC_FLAGS 占位符文件和文件夹的同步状态标志。
CF_SET_PIN_FLAGS 占位符固定标志。
CF_SYNC_PROVIDER_STATUS 同步提供程序的当前状态。
CF_SYNC_ROOT_INFO_CLASS 同步根信息的类型。
CF_UPDATE_FLAGS 用于更新占位符文件或目录的标志。