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


Интерфейс 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