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

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

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

Примечание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

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

  • Last updated on