此标头由云筛选器 API 使用。 有关详细信息,请参阅:
cfapi.h 包含以下编程接口:
函数
| 
              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  为普通文件和占位符文件) 打开文件或目录的异步不透明句柄 (,并根据打开的标志设置正确的 oplock。  | 
| 
              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  允许同步提供程序控制平台应如何冻结占位符文件。 这是可与主 policy:_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  定义填充策略修饰符。 这是可与主 policy:_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  用于更新占位符文件或目录的标志。  |