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 現在実行中のタスクを含むインターフェイスです。

IRunningTaskCollection インターフェイス ポインターNULL への参照を渡します。 以外の NULL ポインターを参照すると、ポインターが上書きされるため、メモリ リークが発生する可能性があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

	形容
E_INVALIDARG	メソッド呼び出しで無効な引数が指定されました。 パラメーター フラグに 0 以外の値を渡すと、E_INVALIDARGが返されます。
S_OK	操作が正常に完了しました。
E_POINTER	retVal パラメーターに NULL が渡されました。
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)	ユーザーがサービスに接続していません。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	taskschd.h
ライブラリ	Taskschd.lib
DLL	Taskschd.dll

関連項目

IRunningTaskCollection

ITaskService の

TASK_ENUM_FLAGS

タスク スケジューラ の