RegisteredTask.RunEx メソッド

  • [アーティクル]

スクリプト作成の場合は、指定したフラグとセッション識別子を使用して、登録されたタスクを直ちに実行します。

構文

RegisteredTask.RunEx( _
  ByVal params, _
  ByVal flags, _
  ByVal sessionID, _
  ByRef runningTask _
)

パラメーター

params [in]

タスク アクションの値として使用されるパラメーター。 タスク アクションにパラメーター値を指定しない場合は、このパラメーターを Nothing に設定します。 それ以外の場合は、1 つの文字列値または文字列値の配列を指定できます。

指定した文字列値は名前とペアになり、名前と値のペアとして格納されます。 1 つの文字列値を指定した場合、Arg0 は値に割り当てられた名前になります。 この値は、アクション のプロパティで $(Arg0) 変数が使用されるタスク アクションで使用できます。

文字列値の配列として "0"、"100"、"250" などの値を渡すと、"0" は $(Arg0) 変数を置き換え、"100" は $(Arg1) 変数を置き換え、"250" はアクション プロパティで使用される $(Arg2) 変数を置き換えます。

最大 32 個の文字列値を指定できます。

値に $(Arg0)、$(Arg1)、...、$(Arg32) 変数を使用できるアクション プロパティの詳細と一覧については、「 タスク アクション」を参照してください。

flags [in]

タスク の 実行方法を定義するTASK_RUN_FLAGS定数。

sessionID [in]

タスクを起動するターミナル サーバー セッション。

TASK_RUN_USE_SESSION_ID定数 (0x4) が flags パラメーターに渡されない場合、このパラメーターで指定された値は無視されます。 TASK_RUN_USE_SESSION_ID定数が flags パラメーターに渡され、sessionID 値が 0 以下の場合は、無効な引数エラーが返されます。

TASK_RUN_USE_SESSION_ID定数が flags パラメーターに渡され、sessionID 値が 0 より大きい有効なセッション ID であり、 ユーザー パラメーターに値が指定されていない場合、タスク スケジューラ サービスは、指定されたセッションにログオンしているユーザーとして対話形式でタスクを起動しようとします。

TASK_RUN_USE_SESSION_ID定数が flags パラメーターに渡され、sessionID 値が 0 より大きい有効なセッション ID であり、 ユーザーがユーザー パラメーターで指定されている場合、タスク スケジューラ サービスは、 ユーザー パラメーターで指定されたユーザーとして対話形式でタスクを起動しようとします。

runningTask [out]

タスクの新しいインスタンスを定義する RunningTask オブジェクト。

戻り値

このメソッドは値を返しません。

解説

このメソッドはエラーなしでを返しますが、登録されたタスクの TaskSettings.AllowDemandStart プロパティが false に設定されている場合、タスクは実行されません。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
タイプ ライブラリ
Taskschd.tlb
[DLL]
Taskschd.dll

関連項目

タスク スケジューラ

RegisteredTask