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

Статья
03/02/2024

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

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

Синтаксис

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

Параметры

[in] flags

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

[out] ppRunningTasks

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	taskschd.h
Библиотека	Taskschd.lib
DLL	Taskschd.dll

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

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

Планировщик заданий

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