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


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

Удаляет задание из очереди передачи и удаляет связанные временные файлы из клиента (загрузки) и сервера (отправки).

Синтаксис

HRESULT Cancel();

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

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

Код возврата Описание
S_OK
Задание успешно отменено.
BG_S_UNABLE_TO_DELETE_FILES
Задание успешно отменено; однако службе не удалось удалить временные файлы, связанные с заданием.
BG_E_INVALID_STATE
Невозможно отменить задание с состоянием BG_JOB_STATE_CANCELLED или BG_JOB_STATE_ACKNOWLEDGED.

Комментарии

Вы можете отменить задание в любое время; однако задание не может быть восстановлено после его отмены.

Для заданий отправки, если сервер недоступен, может возникнуть задержка, прежде чем BITS удалит задание из очереди. BITS периодически отправляет запрос на отмену на сервер BITS в течение 24 часов. Если сервер не отвечает в течение 24-часового периода, BITS удаляет задание из очереди. Если время ожидания без хода выполнения меньше 24 часов, BITS использует период ожидания без хода выполнения для ограничения повторных попыток.

Метод Cancel отменяет отправку, если отправка не завершена. Если отправка завершена и задание имеет тип BG_JOB_TYPE_UPLOAD_REPLY, метод отменяет ответ.

Требования

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

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

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend