IBackgroundCopyFile6：：RequestFileRanges 方法 (bits10_1.h)

添加一组新的文件范围，以便优先下载。

语法

HRESULT RequestFileRanges(
  [in] DWORD                  rangeCount,
  [in] const BG_FILE_RANGE [] ranges
);

[in] rangeCount

指定 Ranges 数组的大小。

[in] ranges

要下载的文件范围的数组。允许请求的范围与之前下载 (或挂起) 范围重叠。范围会自动拆分为非重叠范围。

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。如果请求范围的任何部分超出实际文件大小，则返回BG_E_INVALID_RANGE;如果作业不是下载作业或服务器失去支持下载范围的能力，则返回BG_E_RANDOM_ACCESS_NOT_SUPPORTED。

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

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

下载所有请求的范围后，如果传输了文件的所有字节，作业状态将设置为 BG_JOB_STATE_TRANSFERRED 。否则，作业状态将设置为 BG_JOB_STATE_SUSPENDED。