ITaskService::GetRunningTasks 方法(taskschd.h)

获取正在运行的任务的集合。

注意ITaskService::GetRunningTasks 将仅返回运行的任务集合,这些任务在用户的安全上下文中或以下运行。 例如,对于管理员组的成员,GetRunningTasks 将返回所有正在运行的任务的集合,但对于用户组的成员,GetRunningTasks 将仅返回用户组安全上下文下运行的任务集合。

 

语法

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

参数

[in] flags

来自 TASK_ENUM_FLAGS 枚举的值。 传入 0 以返回非隐藏任务正在运行的任务集合。

[out] ppRunningTasks

IRunningTaskCollection 接口,其中包含当前正在运行的任务。

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

返回值

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

描述
E_INVALIDARG
方法调用中指定了无效参数。 将非零值传递给 标志 参数将返回 E_INVALIDARG
S_OK
操作已成功完成。
E_POINTER
NULL 传递到 retVal 参数中。
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)
用户尚未连接到服务。

要求

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

另请参阅

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

任务计划程序