Интерфейс IBackgroundCopyJob

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

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

Элементы

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

• Методы

Методы

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

Метод	Описание
Отменить	Отменяет задание и удаляет временные файлы из клиента.
Завершить	Завершает задание и сохраняет переданные файлы на клиенте.
EnumFiles	Возвращает указатель интерфейса на объект перечислителя, который используется для перечисления файлов в задании.
GetDisplayName	Извлекает отображаемое имя, идентифицирующее задание.
GetError	Извлекает указатель интерфейса на объект ошибки после возникновения ошибки.
GetId	Извлекает идентификатор задания в очереди.
GetNoProgressTimeout	Извлекает время, в течение которого оптимизация доставки продолжает пытаться передать файл после возникновения временной ошибки.
GetNotifyFlags	Извлекает флаги уведомления о событиях (обратного вызова), заданные для приложения.
GetNotifyInterface	Извлекает указатель на реализацию интерфейса IBackgroundCopyCallback (обратные вызовы).
GetPriority	Возвращает уровень приоритета, заданный для задания.
GetProgress	Извлекает связанные с заданием сведения о ходе выполнения, такие как количество байтов и файлов, переданных клиенту.
GetState	Извлекает состояние задания.
GetTimes	Извлекает метки времени для действий, связанных с заданием, например время создания задания.
GetType	Извлекает тип выполняемой передачи, например скачивание файла.
Возобновить	Запускает новое задание или перезапускает приостановленное задание.
SetNoProgressTimeout	Указывает продолжительность времени, в течение которой оптимизация доставки продолжает пытаться передать файл после возникновения временной ошибки.
SetNotifyFlags	Указывает тип получаемого уведомления о событии.
SetNotifyInterface	Указывает указатель на реализацию интерфейса IBackgroundCopyCallback (обратных вызовов). Интерфейс получает уведомление на основе установленных флагов уведомлений о событиях.
SetPriority	Указывает приоритет задания относительно других заданий в очереди передачи.
Приостановить	Приостанавливает задание.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1709 [только классические приложения]
Минимальная версия сервера	Windows Server версии 1709 [только классические приложения]
Заголовок	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Библиотека	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyJob определяется как 37668D37-507E-4160-9316-26306D150B12

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

IBackgroundCopyFile

IBackgroundCopyManager