Метод IBackgroundCopyJob4::SetMaximumDownloadTime (bits3_0.h)

Задает максимальное время, которое BITS будет тратить на передачу файлов в задании.

Синтаксис

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

Параметры

[in] Timeout

Максимальное время (в секундах), которое BITS будет тратить на передачу файлов в задании. По умолчанию это 7 776 000 секунд (90 дней).

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

Метод возвращает следующие возвращаемые значения.

Код возврата Описание
S_OK
Успешное завершение

Комментарии

Значение — это максимальное затраченное время, которое задание может потратить в состоянии CONNECTING или TRANSFERRING. Время, затраченное в состоянии QUEUED или TRANSIENT_ERROR, не учитывается в значении времени ожидания. Задание переходит в состояние неустранимой ошибки с кодом ошибки BG_E_MAXDOWNLOAD_TIMEOUT если время передачи превышает время ожидания.

Обратите внимание, что если компьютер находится в спящем режиме во время передачи данных задания BITS, время, затраченное на спящий режим, будет учитываться с временем ожидания, даже если данные не передаются.

Вызов метода IBackgroundCopyJob::Resume сбрасывает затраченное время.

Этот метод переопределяет групповую политику MaxDownloadTime.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header bits3_0.h (включая Bits.h)
Библиотека Bits.lib

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

IBackgroundCopyJob4

IBackgroundCopyJob4::GetMaximumDownloadTime