Share via

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
Library Taskschd.lib
[DLL] Taskschd.dll

関連項目

IRegisteredTask

IRunningTaskCollection

タスク スケジューラ