Метод IRegisteredTask::GetInstances (taskschd.h)

Статья
07/16/2024

Возвращает все экземпляры текущей зарегистрированной задачи.

ПримечаниеIRegisteredTask::GetInstances возвращает только экземпляры зарегистрированной задачи, которая выполняется в контексте безопасности пользователя или ниже. Например, для членов группы "Администраторы" GetInstances вернет все экземпляры зарегистрированной задачи, но для членов группы "Пользователи" GetInstances возвращает только экземпляры зарегистрированной задачи, которая выполняется в контексте безопасности группы пользователей.

Синтаксис

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

Параметры

flags

Этот параметр зарезервирован для дальнейшего использования и должен иметь значение 0.

[out] ppRunningTasks

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

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

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

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

Возвращаемый код	Описание
S_OK	Операция успешно завершена.
E_INVALIDARG	Флаг, отличный от NULL, был передан в флаги .
E_POINTER	Значение NULL было передано в параметр ppRunningTasks.

Требования

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

См. также

IRegisteredTask

IRunningTaskCollection

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

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