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 値
指定した BSTR 値は名前とペアになり、名前と値のペアとして格納されます。 1 つの BSTR 値を指定した場合、Arg0 は値に割り当てられた名前になります。 この値は、アクション プロパティで $(Arg0) 変数が使用されるタスク アクションで使用できます。
BSTR 値の
最大 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 より大きい有効なセッション ID であり、ユーザーが ユーザー パラメーターで指定されている場合、タスク スケジューラ サービスは、ユーザー パラメーターで指定されたユーザーとして対話形式でタスクを開始しようとします。
[in] user
タスクを実行するユーザー。
[out, optional] ppRunningTask
タスクの新しいインスタンスを定義する IRunningTask インターフェイス。
IRunningTask インターフェイス ポインター
戻り値
このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。
備考
このメソッドはエラーなしで返されますが、タスクに対して ITaskSettings の allowDemandStart プロパティ
無効なタスクから IRegisteredTask::RunEx
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | taskschd.h |
| ライブラリ | Taskschd.lib |
| DLL | Taskschd.dll |
関連項目
タスク スケジューラ の