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
程式庫 Taskschd.lib
Dll Taskschd.dll

另請參閱

IRegisteredTask

IRunningTaskCollection

工作排程器