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