Метод 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 , а также другие.
| Код возврата | Описание |
|---|---|
|
Задержка повторных попыток успешно настроена. |
|
Состояние задания не может быть 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