Метод IShellTaskScheduler::AddTask (shobjidl_core.h)

Статья
08/26/2023

Добавляет задачу в фоновую очередь планировщика.

Синтаксис

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

Параметры

[in] prt

Тип: IRunnableTask*

Указатель на экземпляр интерфейса IRunnableTask , представляющий задачу для добавления в очередь.

[in] rtoid

Тип: REFTASKOWNERID

GUID, определяющий владельца задачи. Эти сведения можно использовать для группирования задач для последующего подсчета или удаления владельцем.

[in] lParam

Тип: DWORD_PTR

Указатель на определяемое пользователем значение DWORD , позволяющее идентифицировать задачу в задачах, принадлежащих rtoid. Он используется для идентификации отдельных задач или их подгруппировки, например для связывания задачи с определенным элементом, например с элементом в ListView. Этот параметр может быть равен нулю.

[in] dwPriority

Тип: DWORD

Одно из следующих значений, присваивающих приоритет задаче. Реагирование на этот приоритет зависит от сотрудничества других выполняемых задач. Новые задачи вставляются в очередь в порядке приоритета. Если задача с низким приоритетом в настоящее время выполняется при добавлении задачи с более высоким приоритетом, планировщик пытается приостановить выполнение задачи. Эта задача с более низким приоритетом возобновляется после завершения задач с более высоким приоритетом.

ITSAT_DEFAULT_PRIORITY

Примите приоритет по умолчанию, назначенный задаче планировщиком.

ITSAT_MAX_PRIORITY

Высокий приоритет.

ITSAT_MIN_PRIORITY

Низкий приоритет.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll (версия 5.0 или более поздняя)

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