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

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

構文

HRESULT RunEx(
  [in]            VARIANT      params,
  [in]            LONG         flags,
  [in]            LONG         sessionID,
  [in]            BSTR         user,
  [out, optional] IRunningTask **ppRunningTask
);

パラメーター

[in] params

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

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

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

最大 32 BSTR 値を指定できます。

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

[in] flags

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

[in] sessionID

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

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

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

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

[in] user

タスクを実行するユーザー。

[out, optional] ppRunningTask

タスクの新しいインスタンスを定義する IRunningTask インターフェイス。

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

戻り値

このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。

備考

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

無効なタスクから IRegisteredTask::RunEx 呼び出されると、S_OKが返されますが、タスクは実行されません。

必要条件

関連項目

IRegisteredTask

タスク スケジューラ の