CfReportProviderProgress 函数 (cfapi.h)

  • 项目

允许同步提供程序报告带外进度。

语法

HRESULT CfReportProviderProgress(
  [in] CF_CONNECTION_KEY ConnectionKey,
  [in] CF_TRANSFER_KEY   TransferKey,
  [in] LARGE_INTEGER     ProviderProgressTotal,
  [in] LARGE_INTEGER     ProviderProgressCompleted
);

参数

[in] ConnectionKey

表示具有同步筛选器的信道的连接键。

[in] TransferKey

占位符的不透明句柄。

[in] ProviderProgressTotal

同步提供程序响应提取数据回调的总进度。

[in] ProviderProgressCompleted

同步提供程序响应提取数据回调的已完成进度。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

筛选器通过跟踪为响应FETCH_DATA回调而传输和/或确认的范围，自动跟踪 混合 的进度。 但是，如果提供商在开始 TRANSFER_DATA 筛选器之前花费大量时间将内容下载到临时位置，则筛选器将不知道这些活动与请求有任何关系。

通过定期调用 CfReportProviderProgress ，同步提供程序可以向筛选器报告进度，从而重置对应于 CF_CALLBACK_TYPE_FETCH_DATA 回调的 60 秒超时期限。 这也将使进度看起来更流畅。

要求

要求 值
最低受支持的客户端 Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 cfapi.h
Library CldApi.lib
DLL CldApi.dll

另请参阅

CfReportProviderProgress2

CF_CALLBACK_TYPE