Метод IBackgroundCopyJob::SetMinimumRetryDelay (bits.h)

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

Синтаксис

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

Параметры

[in] Seconds

Минимальная продолжительность (в секундах) ожидания BITS после возникновения временной ошибки перед попыткой передачи файла. Задержка повторных попыток по умолчанию составляет 600 секунд (10 минут). Минимальная задержка повторных попыток, которую можно указать, составляет 5 секунд. Если указать значение меньше 5 секунд, BITS изменит значение на 5 секунд. Если значение превышает значение no-progress-timeout, полученное из метода GetNoProgressTimeout , BITS не будет повторять передачу и перемещать задание в состояние BG_JOB_STATE_ERROR.

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

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

Код возврата Описание
S_OK
Задержка повторных попыток успешно настроена.
BG_E_INVALID_STATE
Состояние задания не может быть BG_JOB_STATE_CANCELLED или BG_JOB_STATE_ACKNOWLEDGED.

Комментарии

Чтобы запустить задание до истечения минимального периода повтора, вызовите метод IBackgroundCopyJob::Resume .

BITS не повторяет задание, если произошла ошибка отключения сети или блокировки диска (например, работает chkdsk) или если групповая политика MaxInternetBandwidth равно нулю.

Примечание Изменение системных часов не влияет на минимальную задержку повторных попыток. Например, если текущее время — 14:00, а BITS — повторить задание в 14:10, то перемещение системных часов вперед на десять или более минут не означает, что BITS будет повторять задание раньше. BITS по-прежнему будет повторять задание в течение десяти минут. Чтобы отразить изменение системных часов в BITS, необходимо перезагрузить компьютер или службу BITS.

Требования

Требование Значение
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Целевая платформа Windows
Header bits.h
Библиотека Bits.lib
DLL QmgrPrxy.dll

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

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout