Метод IBackgroundCopyFile2::GetFileRanges (bits2_0.h)

Извлекает диапазоны, которые требуется скачать из удаленного файла.

Синтаксис

HRESULT GetFileRanges(
  [in, out] DWORD         *RangeCount,
  [out]     BG_FILE_RANGE **Ranges
);

Параметры

[in, out] RangeCount

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

[out] Ranges

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

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

Этот метод возвращает следующие возвращаемые значения, а также другие.

Код возврата Описание
S_OK
Успешное завершение
S_FALSE
Диапазоны не указаны или задание является заданием отправки или отправки и ответа. Значение RangeCount равно нулю, а параметру Ranges присвоено значение NULL.

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2), KB842773 в Windows Server 2003 и Windows XP
Минимальная версия сервера Windows Server 2008, Windows Server 2003 с пакетом обновления 1 (SP1)
Целевая платформа Windows
Header bits2_0.h (включая Bits.h)
Библиотека Bits.lib
DLL BitsPrx3.dll

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

BG_FILE_RANGE

IBackgroundCopyFile2

IBackgroundCopyJob3::AddFileWithRanges