Метод IBackgroundCopyManager::CreateJob

Создает задание.

Синтаксис

HRESULT CreateJob(
  [in]  LPCWSTR            pDisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobID,
  [out] IBackgroundCopyJob **ppJob
);

Параметры

pDisplayName [in]

Строка, завершающаяся значением NULL, содержащая отображаемое имя задания. Как правило, отображаемое имя используется для идентификации задания в пользовательском интерфейсе. Обратите внимание, что несколько заданий могут иметь одно отображаемое имя. Не должно иметь значение NULL. Длина имени ограничена 256 символами, не включая символ конца NULL.

Введите [в]

Тип задания передачи, например BG_JOB_TYPE_DOWNLOAD. Список типов передачи см. в перечислении BG_JOB_TYPE .

pJobID [out]

Уникально идентифицирует задание в очереди. Используйте этот идентификатор при вызове метода IBackgroundCopyManager::GetJob для получения задания из очереди.

ppJob [out]

Указатель интерфейса IBackgroundCopyJob , который используется для изменения свойств задания и указания файлов для передачи. Чтобы активировать задание в очереди, вызовите метод IBackgroundCopyJob::Resume . По завершении отпустите ppJob .

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

Этот метод возвращает следующие значения HRESULT , а также другие.

Код возврата	Описание
S_OK	Новое задание успешно создано.

Комментарии

Добавлять файлы в задание и изменять свойства задания могут только пользователь, создающий задание, или пользователь с правами администратора.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1709 [только классические приложения]
Минимальная версия сервера	Windows Server версии 1709 [только классические приложения]
Заголовок	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Библиотека	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyManager определяется как 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C

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

IBackgroundCopyManager

IBackgroundCopyJob

IBackgroundCopyJob::Resume