Метод IBackgroundCopyJob::Complete

Завершает задание и сохраняет переданные файлы на клиенте.

Синтаксис

HRESULT Complete();

Параметры

Этот метод не имеет параметров.

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

Этот метод возвращает следующие значения HRESULT . Метод также может возвращать ошибки, связанные с переименованием временных копий переданных файлов в заданные имена.

Код возврата	Описание
S_OK	Все файлы успешно переданы.
DO_E_INVALID_STATE	Для скачиваний состояние задания не может быть BG_JOB_STATE_CANCELLED или BG_JOB_STATE_ACKNOWLEDGED. Для отправки задание должно быть BG_JOB_STATE_TRANSFERRED.

Комментарии

Все файлы успешно переданы, если задание находится в состоянии BG_JOB_STATE_TRANSFERRED. Чтобы проверка состояние задания, вызовите метод IBackgroundCopyJob::GetState. Вы также можете реализовать интерфейс IBackgroundCopyCallback , чтобы получать уведомления о передаче всех файлов клиенту.

При оптимизации доставки сохраняются задания, срок действия которых не превышает 30 дней. Все старые задания будут удалены. Оптимизация доставки не поддерживает групповая политика JobInactivityTimeout.

Для заданий скачивания метод Complete можно вызвать в любое время во время процесса передачи. однако сохраняются только файлы, которые были успешно переданы клиенту перед вызовом этого метода. Например, при вызове метода Complete во время оптимизации доставки обрабатывается третий из пяти файлов, сохраняются только первые два файла. Чтобы определить, какие файлы были переданы, вызовите метод IBackgroundCopyFile::GetProgress и сравните элемент BytesTransferred с элементом BytesTotalструктуры BG_FILE_PROGRESS .

Для отправки заданий метод Complete можно вызывать только в том случае, если задание находится в состоянии BG_JOB_STATE_TRANSFERRED.

Владельцем файла является пользователь, который совершил вызов. Например, если администратор выполняет задание другого пользователя, файл будет принадлежать администратору, не являщемуся владельцем задания.

Требования

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

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

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::GetState