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

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

Синтаксис

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

Параметры

[in] DisplayName

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

[in] Type

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

[out] pJobId

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

[out] ppJob

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

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

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

Замечания

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

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

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

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

Примеры

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

Требования

См. также

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

IBackgroundCopyJob

IBackgroundCopyJob::Resume