Метод IBackgroundCopyManager::CreateJob (bits.h)

Статья
08/22/2023

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

Синтаксис

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

Параметры

[in] DisplayName

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

[in] Type

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

[out] pJobId

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

[out] ppJob

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

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

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

Код возврата	Описание
S_OK	Новое задание успешно создано.
E_INVALIDARG	Отображаемое имя слишком длинное.
BG_E_TOO_MANY_JOBS_PER_MACHINE	Параметр групповая политика MaxJobsPerMachine определяет, сколько заданий можно создать на компьютере. При добавлении этого задания превышено ограничение MaxJobsPerMachine.
BG_E_TOO_MANY_JOBS_PER_USER	Параметр групповая политика MaxJobsPerUser определяет, сколько заданий может создать пользователь. Добавление этого задания превышает ограничение MaxJobsPerUser.

По умолчанию BITS поддерживает не более 300 заданий одновременно. Один пользователь может одновременно создать не более 60 заданий. Ограничение пользователей не применяется к администраторам или учетным записям служб. Чтобы изменить значения по умолчанию, задайте групповые политики MaxJobsPerMachine и MaxJobsPerUser соответственно.

До Windows Vista: Нет ограничений на количество заданий, поддерживаемых BITS или которые может создать пользователь.

Сведения о масштабируемости см. в статье Рекомендации по использованию BITS.

Примеры

Пример создания задания см. в разделе Создание задания.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Минимальная версия сервера	Windows Server 2003
Целевая платформа	Windows
Header	bits.h
Библиотека	Bits.lib
DLL	QmgrPrxy.dll

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

Создание задания

IBackgroundCopyJob

IBackgroundCopyJob::Resume

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