Метод IBackgroundCopyFile6::GetFilledFileRanges (bits10_1.h)

Статья
02/23/2024

Возвращает набор скачанных диапазонов файлов.

Синтаксис

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

Параметры

[out] rangeCount

Количество элементов в диапазонах.

[out] ranges

Массив BG_FILE_RANGE структур, описывающих скачанные диапазоны. Диапазоны будут объединены вместе насколько это возможно. Диапазоны упорядочены по смещению. По завершении вызовите функцию CoTaskMemFree , чтобы освободить диапазоны.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Ошибка будет E_OUTOFMEMORY , если не удалось выделить массив Ranges и BG_E_RANDOM_ACCESS_NOT_SUPPORTED , если задание не является заданием скачивания или сервер теряет возможность поддерживать диапазоны загрузки.

Для задания BITS_JOB_PROPERTY_ON_DEMAND_MODE требуется, чтобы передача была заданием ЗАГРУЗКИ . Задание не должно быть динамическим , а сервер должен быть HTTP или HTTPS-сервером, а требования к серверу для поддержки диапазона должны быть выполнены. Дополнительные сведения см. в разделе Http Requirements for BITS Downloads.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1703 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	bits10_1.h (включая Bits.h)
Библиотека	Bits.lib

См. также раздел

IBackgroundCopyFile6

Share via