次の方法で共有


IRegisteredTask::GetInstances メソッド (taskschd.h)

現在実行中の登録済みタスクのすべてのインスタンスを返します。

IRegisteredTask::GetInstancesは、ユーザーのセキュリティ コンテキスト以下で実行されている現在実行中の登録済みタスクのインスタンスのみを返します。 たとえば、Administrators グループのメンバーの場合、GetInstances は現在実行中の登録済みタスクのすべてのインスタンスを返しますが、Users グループのメンバーの 場合、GetInstances は、Users グループセキュリティ コンテキストで実行されている現在実行中の登録済みタスクのインスタンスのみを返します。

 

構文

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

パラメーター

flags

このパラメーターは将来使用するために予約されており、0 に設定する必要があります。

[out] ppRunningTasks

IRunningTaskCollection、ユーザーのコンテキストでタスクの現在実行中のすべてのインスタンスを含むインターフェイスです。

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

戻り値

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

リターン コード 形容
S_OK
操作が正常に完了しました。
E_INVALIDARG
null 以外のフラグがパラメーター フラグに渡されました。
E_POINTER
ppRunningTasks パラメーターに NULL が渡されました。

必要条件

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

関連項目

IRegisteredTask

IRunningTaskCollection

タスク スケジューラ の