ITaskService：：GetRunningTasks 方法 (taskschd.h)

  • 發行項

取得執行中工作的集合。

注意ITaskService：：GetRunningTasks 只會傳回執行中工作集合，這些工作是在使用者的安全性內容或下方執行。 例如，針對 Administrators 群組的成員， GetRunningTasks 會傳回所有執行中工作的集合，但針對 Users 群組的成員， GetRunningTasks 只會傳回在 Users 群組安全性內容下執行的工作集合。

 

語法

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

參數

[in] flags

來自 TASK_ENUM_FLAGS 列舉的值。 傳入 0，以傳回未隱藏之工作的執行中工作集合。

[out] ppRunningTasks

包含目前執行中工作的 IRunningTaskCollection 介面。

傳入 NULLIRunningTaskCollection 介面指標的參考。 參考非 NULL 指標可能會導致記憶體流失，因為將會覆寫指標。

傳回值

這個方法可以傳回下列其中一個值。

Description
E_INVALIDARG
 方法呼叫中指定了無效的自變數。 將非零值傳遞至 flags 參數會 傳回E_INVALIDARG。
S_OK
 作業已成功完成。
E_POINTER
 NULL 已傳遞至 retVal 參數。
HRESULT_FROM_WIN32 (ERROR_ONLY_IF_CONNECTED)
使用者尚未連線到服務。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 taskschd.h
程式庫 Taskschd.lib
Dll Taskschd.dll

另請參閱

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

工作排程器