RegisteredTask.Run メソッド

スクリプトの場合は、登録されたタスクを直ちに実行します。

構文

RegisteredTask.Run( _
  ByVal params, _
  ByRef ppRunningTask _
)

params [in]

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

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

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

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

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

ppRunningTask [out]

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

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

RegisteredTask.Run 関数は、flags パラメーターが 0 で、ユーザーパラメーターに何も指定されていない RegisteredTask.RunEx 関数と同じです。

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