Метод ITaskService::GetRunningTasks (taskschd.h)

Статья
07/16/2024

Возвращает коллекцию выполняемых задач.

примечаниеITaskService::GetRunningTasks возвращает только коллекцию выполняемых задач, выполняемых в контексте безопасности пользователя или ниже. Например, для членов группы "Администраторы" GetRunningTasks возвращает коллекцию всех выполняемых задач, но для членов группы "Пользователи" GetRunningTasks возвращает только коллекцию задач, выполняемых в контексте безопасности группы "Пользователи".

Синтаксис

HRESULT GetRunningTasks(
  [in]  LONG                   flags,
  [out] IRunningTaskCollection **ppRunningTasks
);

Параметры

[in] flags

Значение из перечисления TASK_ENUM_FLAGS. Передайте 0, чтобы вернуть коллекцию выполняемых задач, которые не являются скрытыми.

[out] ppRunningTasks

Интерфейс IRunningTaskCollection , содержащий выполняемые в настоящее время задачи.

Передайте ссылку на указатель интерфейса NULLIRunningTaskCollect ion. Ссылка на указатель, неNULL может привести к утечке памяти, так как указатель будет перезаписан.

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

Этот метод может возвращать одно из этих значений.

	Описание
E_INVALIDARG	Недопустимый аргумент был указан в вызове метода. Передача ненулевого значения флага параметр вернет E_INVALIDARG.
S_OK	Операция успешно завершена.
E_POINTER	Значение NULL было передано в параметр retVal.
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)	Пользователь не подключен к службе.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	taskschd.h
библиотеки	Taskschd.lib
DLL	Taskschd.dll

См. также

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

планировщик задач

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