ITaskSettings インターフェイス (taskschd.h)
タスク スケジューラ サービスがタスクの実行に使用する設定を提供します。
継承
ITaskSettings インターフェイスは IDispatch インターフェイスから継承されます。
メソッド
ITaskSettings インターフェイスには、これらのメソッドがあります。
| ITaskSettings::get_AllowDemandStart [実行] コマンドまたは [コンテキスト] メニューを使用してタスクを開始できることを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_AllowHardTerminate TerminateProcess を使用してタスク スケジューラ サービスによってタスクが終了される可能性があることを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_Compatibility タスクと互換性のあるタスク スケジューラのバージョンを示す整数値を取得または設定します。 (Get) |
| ITaskSettings::get_DeleteExpiredTaskAfter タスク スケジューラが期限切れ後にタスクを削除するまでに待機する時間を取得または設定します。 (Get) |
| ITaskSettings::get_DisallowStartIfOnBatteries コンピューターがバッテリで実行されている場合にタスクが開始されないことを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_Enabled タスクが有効になっていることを示すブール値を取得または設定します。 タスクは、この設定が True の場合にのみ実行できます。 |
| ITaskSettings::get_ExecutionTimeLimit タスクを完了できる時間を取得または設定します。 (Get) |
| ITaskSettings::get_Hidden タスクが UI に表示されないことを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_IdleSettings コンピューターがアイドル状態のときにタスク スケジューラがタスクを実行する方法を指定する情報を取得または設定します。 (Get) |
| ITaskSettings::get_MultipleInstances タスク スケジューラがタスクの複数のインスタンスを処理する方法を定義するポリシーを取得または設定します。 (Get) |
| ITaskSettings::get_NetworkSettings ネットワーク プロファイルの識別子と名前を含むネットワーク設定オブジェクトを取得または設定します。 (Get) |
| ITaskSettings::get_Priority タスクの優先度レベルを取得または設定します。 (Get) |
| ITaskSettings::get_RestartCount タスク スケジューラがタスクの再起動を試行する回数を取得または設定します。 (Get) |
| ITaskSettings::get_RestartInterval タスク スケジューラがタスクの再起動を試みる時間を指定する値を取得または設定します。 (Get) |
| ITaskSettings::get_RunOnlyIfIdle コンピューターがアイドル状態の場合にのみタスク スケジューラがタスクを実行することを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_RunOnlyIfNetworkAvailable ネットワークが使用可能な場合にのみタスク スケジューラがタスクを実行することを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_StartWhenAvailable スケジュールされた時刻が経過した後、タスク スケジューラがタスクをいつでも開始できることを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_StopIfGoingOnBatteries コンピューターがバッテリに移動する場合にタスクが停止されることを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_WakeToRun タスクスケジューラがタスクの実行時にコンピューターをスリープ解除し、タスクが完了するまでコンピューターの起動を維持することを示すブール値を取得または設定します。 (Get) |
| ITaskSettings::get_XmlText タスク設定の XML 形式の定義を取得または設定します。 (Get) |
| ITaskSettings::p ut_AllowDemandStart [実行] コマンドまたは [コンテキスト] メニューを使用してタスクを開始できることを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_AllowHardTerminate TerminateProcess を使用してタスク スケジューラ サービスによってタスクが終了される可能性があることを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_Compatibility タスクと互換性のあるタスク スケジューラのバージョンを示す整数値を取得または設定します。 (Put) |
| ITaskSettings::p ut_DeleteExpiredTaskAfter タスク スケジューラが期限切れ後にタスクを削除するまでに待機する時間を取得または設定します。 (Put) |
| ITaskSettings::p ut_DisallowStartIfOnBatteries コンピューターがバッテリで実行されている場合にタスクが開始されないことを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_ExecutionTimeLimit タスクを完了できる時間を取得または設定します。 (Put) |
| ITaskSettings::p ut_Hidden タスクが UI に表示されないことを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_IdleSettings コンピューターがアイドル状態のときにタスク スケジューラがタスクを実行する方法を指定する情報を取得または設定します。 (Put) |
| ITaskSettings::p ut_MultipleInstances タスク スケジューラがタスクの複数のインスタンスを処理する方法を定義するポリシーを取得または設定します。 (Put) |
| ITaskSettings::p ut_NetworkSettings ネットワーク プロファイルの識別子と名前を含むネットワーク設定オブジェクトを取得または設定します。 (Put) |
| ITaskSettings::p ut_Priority タスクの優先度レベルを取得または設定します。 (Put) |
| ITaskSettings::p ut_RestartCount タスク スケジューラがタスクの再起動を試行する回数を取得または設定します。 (Put) |
| ITaskSettings::p ut_RestartInterval タスク スケジューラがタスクの再起動を試みる時間を指定する値を取得または設定します。 (Put) |
| ITaskSettings::p ut_RunOnlyIfIdle コンピューターがアイドル状態の場合にのみタスク スケジューラがタスクを実行することを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_RunOnlyIfNetworkAvailable ネットワークが使用可能な場合にのみタスク スケジューラがタスクを実行することを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_StartWhenAvailable スケジュールされた時刻が経過した後、タスク スケジューラがタスクをいつでも開始できることを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_StopIfGoingOnBatteries コンピューターがバッテリに移動する場合にタスクが停止されることを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_WakeToRun タスクスケジューラがタスクの実行時にコンピューターをスリープ解除し、タスクが完了するまでコンピューターの起動を維持することを示すブール値を取得または設定します。 (Put) |
| ITaskSettings::p ut_XmlText タスク設定の XML 形式の定義を取得または設定します。 (Put) |
注釈
既定では、タスクは実行を開始してから 72 時間後に停止されます。 これを変更するには、 ExecutionTimeLimit 設定を変更します。
タスクの XML の読み取りまたは書き込み時に、タスク設定はタスク スケジューラ スキーマの Settings 要素で定義されます。
バッテリー セーバーがオンの場合、Windows タスク スケジューラ タスクは、タスクが次の場合にのみトリガーされます。
- [Start the task only if the computer is idle...] (コンピューターがアイドル状態の場合のみタスクを開始する) に設定されていない (タスクで IdleSettings を使用していない)
- 自動メンテナンス中に実行するよう設定されていない (タスクで MaintenanceSettings を使用していない)。
- [ユーザーがログオンしているときのみ実行する] に設定されている (タスクの LogonType が TASK_LOGON_INTERACTIVE_TOKEN または TASK_LOGON_GROUP)
例
このインターフェイスの詳細とコード例については、「 タイム トリガーの例 (C++)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | taskschd.h |