Метод 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 возвращается, если задание не является заданием загрузки или сервер теряет возможность поддерживать диапазоны загрузки.
Комментарии
RequestFileRanges можно запросить для любого задания загрузки, которое также соответствует требованиям для BITS_JOB_PROPERTY_ON_DEMAND_MODE заданий .
Для задания BITS_JOB_PROPERTY_ON_DEMAND_MODE требуется, чтобы передача была заданием ЗАГРУЗКИ . Задание не должно быть динамическим , а сервер должен быть HTTP или HTTPS-сервером, а требования к серверу для поддержки диапазона должны быть выполнены. Дополнительные сведения см. в разделе Http Requirements for BITS Downloads.
После скачивания всех запрошенных диапазонов состояние задания будет установлено в BG_JOB_STATE_TRANSFERRED , если были переданы все байты файла. В противном случае для задания будет задано состояние BG_JOB_STATE_SUSPENDED.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10, версия 1703 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2016 [только классические приложения] |
| Целевая платформа | Windows |
| Header | bits10_1.h (включая Bits.h) |
| Библиотека | Bits.lib |