Перечисление BG_JOB_STATE (bits.h)

  • Статья

Определяет константы, определяющие различные состояния задания.

Синтаксис

typedef enum BG_JOB_STATE {
  BG_JOB_STATE_QUEUED = 0,
  BG_JOB_STATE_CONNECTING,
  BG_JOB_STATE_TRANSFERRING,
  BG_JOB_STATE_SUSPENDED,
  BG_JOB_STATE_ERROR,
  BG_JOB_STATE_TRANSIENT_ERROR,
  BG_JOB_STATE_TRANSFERRED,
  BG_JOB_STATE_ACKNOWLEDGED,
  BG_JOB_STATE_CANCELLED
} ;

Константы

 
BG_JOB_STATE_QUEUED
Значение: 0
Указывает, что задание находится в очереди и ожидает выполнения. Если пользователь завершает работу во время передачи задания, задание переходит в состояние в очереди.
BG_JOB_STATE_CONNECTING
Указывает, что BITS пытается подключиться к серверу. Если подключение выполнено успешно, состояние задания становится BG_JOB_STATE_TRANSFERRING; в противном случае состояние становится BG_JOB_STATE_TRANSIENT_ERROR.
BG_JOB_STATE_TRANSFERRING
Указывает, что BITS передает данные для задания.
BG_JOB_STATE_SUSPENDED
Указывает, что задание приостановлено (приостановлено). Чтобы приостановить задание, вызовите метод IBackgroundCopyJob::Suspend. BITS автоматически приостанавливает задание при его создании. Задание остается приостановленным до вызова метода IBackgroundCopyJob::Resume, метода IBackgroundCopyJob::Complete или метода IBackgroundCopyJob::Cancel.
BG_JOB_STATE_ERROR
Указывает, что произошла неустранимая ошибка (служба не может передать файл). Если эту ошибку, например ошибку отказа в доступе, можно исправить, вызовите
Метод IBackgroundCopyJob::Resume после исправления ошибки. Однако если ошибка не может быть исправлена, вызовите
Метод IBackgroundCopyJob::Cancel чтобы отменить задание, или вызвать
Метод IBackgroundCopyJob::Complete , чтобы принять часть задания загрузки, которая успешно перенесена.
BG_JOB_STATE_TRANSIENT_ERROR
Указывает, что произошла восстанавливаемая ошибка. BITS будет повторять задания в состоянии временной ошибки на основе указанного интервала повтора (см. метод IBackgroundCopyJob::SetMinimumRetryDelay). Состояние задания изменяется на BG_JOB_STATE_ERROR, если выполнение задания не выполняется (см. раздел Метод IBackgroundCopyJob::SetNoProgressTimeout).

BITS не повторяет задание, если произошла ошибка отключения сети или произошла ошибка блокировки диска (например, chkdsk запущена) или групповая политика MaxInternetBandwidth равно нулю.
BG_JOB_STATE_TRANSFERRED
Указывает, что задание успешно обработано. Необходимо вызвать
Метод IBackgroundCopyJob::Complete чтобы подтвердить завершение задания и сделать файлы доступными для клиента.
BG_JOB_STATE_ACKNOWLEDGED
Указывает, что вы вызвали метод IBackgroundCopyJob::Complete, чтобы подтвердить успешное выполнение задания.
BG_JOB_STATE_CANCELLED
Указывает, что вы вызвали
Метод IBackgroundCopyJob::Cancel для отмены задания (т. е. для удаления задания из очереди передачи).

Требования

Требование Значение
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Верхняя часть bits.h

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