IRegisteredTask::GetInstances 方法 (taskschd.h)

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

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

 

语法

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

参数

flags

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

[out] ppRunningTasks

IRunningTaskCollection 接口,该接口包含用户上下文下当前正在运行的任务实例。

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

返回值

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

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

要求

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

另请参阅

IRegisteredTask

IRunningTaskCollection

任务计划程序