перечисление BG_JOB_STATE
Перечисление BG_JOB_STATE определяет значения констант для различных состояний задания.
Синтаксис
typedef enum {
BG_JOB_STATE_QUEUED,
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;
Константы
-
BG_JOB_STATE_QUEUED
-
Указывает, что задание находится в очереди и ожидает выполнения. Если пользователь завершает работу во время передачи задания, задание переходит в состояние в очереди.
-
BG_JOB_STATE_CONNECTING
-
Не поддерживается.
-
BG_JOB_STATE_TRANSFERRING
-
Указывает, что оптимизация доставки передает данные для задания.
-
BG_JOB_STATE_SUSPENDED
-
Указывает, что задание приостановлено (приостановлено). Чтобы приостановить задание, вызовите метод IBackgroundCopyJob::Suspend . Задание остается приостановленным до вызова метода IBackgroundCopyJob::Resume, IBackgroundCopyJob::Complete или IBackgroundCopyJob::Cancel .
-
BG_JOB_STATE_ERROR
-
Указывает, что произошла неустранимая ошибка (службе не удается передать файл). Если ошибку, например ошибку отказа в доступе, можно исправить, вызовите метод IBackgroundCopyJob::Resume после исправления ошибки. Однако если исправить ошибку не удается, вызовите метод IBackgroundCopyJob::Cancel , чтобы отменить задание, или метод IBackgroundCopyJob::Complete , чтобы принять часть успешно переданного задания загрузки.
-
BG_JOB_STATE_TRANSIENT_ERROR
-
Указывает, что произошла восстанавливаемая ошибка. Оптимизация доставки будет повторять задания в состоянии временной ошибки на основе внутренней конфигурации повторных попыток. Состояние задания изменяется на BG_JOB_STATE_ERROR , если выполнение задания не выполняется (см. раздел IBackgroundCopyJob::SetNoProgressTimeout).
-
BG_JOB_STATE_TRANSFERRED
-
Указывает, что задание успешно обработано. Необходимо вызвать метод IBackgroundCopyJob::Complete , чтобы подтвердить завершение задания и сделать файлы доступными для клиента.
-
BG_JOB_STATE_ACKNOWLEDGED
-
Указывает, что вы вызвали метод IBackgroundCopyJob::Complete , чтобы подтвердить успешное выполнение задания.
-
BG_JOB_STATE_CANCELLED
-
Указывает, что вы вызвали метод IBackgroundCopyJob::Cancel , чтобы отменить задание (удалить задание из очереди передачи).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 10, версия 1709 [только классические приложения] |
| Минимальная версия сервера |
Windows Server версии 1709 [только классические приложения] |
| Заголовок |
|