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 要求。