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 |