IBackgroundCopyFile6：：GetFilledFileRanges 方法 (bits10_1.h)

  • 项目

返回已下载的文件范围集。

语法

HRESULT GetFilledFileRanges(
  [out] DWORD         *rangeCount,
  [out] BG_FILE_RANGE **ranges
);

参数

[out] rangeCount

Ranges 中的元素数。

[out] ranges

描述已下载范围 BG_FILE_RANGE 结构的数组。 范围将尽可能合并在一起。 范围按偏移量排序。 完成后，调用 CoTaskMemFree 函数以释放 Ranges。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。 如果无法分配 Ranges 数组，则会E_OUTOFMEMORY错误;如果作业不是下载作业或服务器失去支持下载范围的能力，则会BG_E_RANDOM_ACCESS_NOT_SUPPORTED错误。

注解

可以为满足BITS_JOB_PROPERTY_ON_DEMAND_MODE作业要求的任何下载作业请求 GetFilledFileRanges。

BITS_JOB_PROPERTY_ON_DEMAND_MODE作业的要求是传输必须是 DOWNLOAD 作业。 作业不能是 动态 的，服务器必须是 HTTP 或 HTTPS 服务器，并且必须满足服务器对范围支持的要求。 有关详细信息，请参阅 BITS 下载的 HTTP 要求。

要求

要求 值
最低受支持的客户端 Windows 10版本 1703 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 bits10_1.h (包括 Bits.h)
Library Bits.lib

另请参阅

IBackgroundCopyFile6