ITaskService：：GetRunningTasks 方法 （taskschd.h）

  • 發行項

取得執行中工作的集合。

NoteITaskService：：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 指標可能會導致記憶體流失，因為將會覆寫指標。

傳回值

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

描述
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

工作排程器