IRegisteredTask：：GetInstances 方法 (taskschd.h)

  • 项目

返回当前正在运行的已注册任务的所有实例。

注意IRegisteredTask：：GetInstances 将仅返回当前正在运行的注册任务的实例，这些任务在用户的安全上下文或下方运行。 例如，对于 Administrators 组的成员， GetInstances 将返回当前正在运行的已注册任务的所有实例，但对于 Users 组的成员， GetInstances 将仅返回在 Users 组安全上下文下运行的当前正在运行的已注册任务的实例。

 

语法

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

参数

flags

此参数保留供将来使用，必须设置为 0。

[out] ppRunningTasks

IRunningTaskCollection 接口，其中包含用户上下文下当前正在运行的任务的所有实例。

传入对 NULLIRunningTaskCollection 接口指针的引用。 引用非 NULL 指针可能会导致内存泄漏，因为指针将被覆盖。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 操作已成功完成。
E_INVALIDARG
 非 null 标志已传递到 flags 参数中。
E_POINTER
 NULL 已传递到 ppRunningTasks 参数。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

另请参阅

IRegisteredTask

IRunningTaskCollection

任务计划程序