Интерфейс IBackgroundCopyJob (bits.h)

Используйте интерфейс IBackgroundCopyJob для добавления файлов в задание, задания уровня приоритета задания, определения состояния задания, а также для запуска и остановки задания.

Чтобы создать задание, вызовите метод IBackgroundCopyManager::CreateJob . Чтобы получить указатель интерфейса IBackgroundCopyJob на существующее задание, вызовите метод IBackgroundCopyManager::GetJob .

Наследование

Интерфейс IBackgroundCopyJob наследуется от интерфейса IUnknown . IBackgroundCopyJob также имеет следующие типы членов:

Методы

Интерфейс IBackgroundCopyJob содержит следующие методы.

IBackgroundCopyJob::AddFile Добавляет в задание один файл.
IBackgroundCopyJob::AddFileSet Добавляет несколько файлов в задание.
IBackgroundCopyJob::Cancel Удаляет задание из очереди передачи и удаляет связанные временные файлы из клиента (загрузки) и сервера (отправки).
IBackgroundCopyJob::Complete Завершает задание и сохраняет переданные файлы на клиенте.
IBackgroundCopyJob::EnumFiles Извлекает указатель интерфейса IEnumBackgroundCopyFiles, который используется для перечисления файлов в задании.
IBackgroundCopyJob::GetDescription Получает описание задания.
IBackgroundCopyJob::GetDisplayName Извлекает отображаемое имя для задания. Как правило, отображаемое имя используется для идентификации задания в пользовательском интерфейсе.
IBackgroundCopyJob::GetError Извлекает интерфейс ошибки после возникновения ошибки.
IBackgroundCopyJob::GetErrorCount Извлекает количество попыток bits перенести задание и произошла ошибка.
IBackgroundCopyJob::GetId Извлекает идентификатор, используемый для идентификации задания в очереди.
IBackgroundCopyJob::GetMinimumRetryDelay Извлекает минимальное время ожидания службы после возникновения временной ошибки перед попыткой передачи файла.
IBackgroundCopyJob::GetNoProgressTimeout Извлекает период времени, в течение которого служба пытается передать файл после возникновения временной ошибки. При наличии хода выполнения таймер сбрасывается.
IBackgroundCopyJob::GetNotifyFlags Извлекает флаги уведомления о событиях для задания.
IBackgroundCopyJob::GetNotifyInterface Извлекает указатель интерфейса на реализацию интерфейса IBackgroundCopyCallback.
IBackgroundCopyJob::GetOwner Извлекает удостоверение владельца задания.
IBackgroundCopyJob::GetPriority Получает уровень приоритета для задания. Уровень приоритета определяет, когда задание обрабатывается относительно других заданий в очереди передачи.
IBackgroundCopyJob::GetProgress Извлекает связанные с заданием сведения о ходе выполнения, такие как количество переданных байтов и файлов.
IBackgroundCopyJob::GetProxySettings Извлекает сведения о прокси-сервере, которые задание использует для передачи файлов.
IBackgroundCopyJob::GetState Извлекает состояние задания.
IBackgroundCopyJob::GetTimes Извлекает метки времени, связанные с заданием, например время создания или последнего изменения задания.
IBackgroundCopyJob::GetType Извлекает тип выполняемой передачи, например скачивание или отправку файла.
IBackgroundCopyJob::Resume Активирует новое задание или перезапускает приостановленное задание.
IBackgroundCopyJob::SetDescription Предоставляет описание задания.
IBackgroundCopyJob::SetDisplayName Указывает отображаемое имя для задания. Как правило, отображаемое имя используется для идентификации задания в пользовательском интерфейсе.
IBackgroundCopyJob::SetMinimumRetryDelay Задает минимальный период времени ожидания BITS после возникновения временной ошибки перед попыткой передачи файла.
IBackgroundCopyJob::SetNoProgressTimeout Задает период времени, в течение времени, когда BITS пытается передать файл после возникновения временной ошибки. При наличии хода выполнения таймер сбрасывается.
IBackgroundCopyJob::SetNotifyFlags Указывает тип уведомления о событии, которое вы хотите получить, например события, переданные заданиями.
IBackgroundCopyJob::SetNotifyInterface Определяет реализацию интерфейса IBackgroundCopyCallback для BITS. Используйте интерфейс IBackgroundCopyCallback для получения уведомлений о событиях, связанных с заданиями.
IBackgroundCopyJob::SetPriority Указывает уровень приоритета задания. Уровень приоритета определяет, когда задание обрабатывается относительно других заданий в очереди передачи.
IBackgroundCopyJob::SetProxySettings Указывает, какой прокси-сервер следует использовать для передачи файлов.
IBackgroundCopyJob::Suspend Приостанавливает задание. Новые задания, задания с ошибкой и задания, которые завершили передачу файлов, приостанавливаются автоматически.
IBackgroundCopyJob::TakeOwnership Изменяет владельца задания на текущего пользователя.

Требования

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

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

IBackgroundCopyFile

IBackgroundCopyJob2

IBackgroundCopyJob3

IBackgroundCopyManager

IEnumBackgroundCopyJobs