Поделиться через


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

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

Синтаксис

HRESULT SetNoProgressTimeout(
  [in] ULONG Seconds
);

Параметры

[in] Seconds

Продолжительность времени (в секундах), когда BITS пытается передать файл после первой временной ошибки. Период повтора по умолчанию составляет 1 209 600 секунд (14 дней). Задайте для периода повтора значение 0, чтобы предотвратить повторные попытки и принудительно перейти в состояние BG_JOB_STATE_ERROR для всех ошибок. Если значение периода повтора превышает значение групповая политика JobInactivityTimeout (по умолчанию 90 дней), BITS отменяет задание после превышения значения политики.

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

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

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

Комментарии

Если bits не выполняется в течение периода повтора, он перемещает состояние задания с BG_JOB_STATE_TRANSIENT_ERROR на BG_JOB_STATE_ERROR. Если вы запрашиваете уведомление об ошибке, BITS вызывает обратный вызов JobError .

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

Требования

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

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

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay