ITaskSettings

Task Scheduler サービスがタスクを実行する際に使用する設定を提供します。

既定では、タスクは実行開始から 72 時間後に停止されます。これは ExecutionTimeLimit 設定を変更することで変更できます。

タスクの XML を読み書きする場合、タスクの設定は Task Scheduler スキーマの Settings 要素で定義されます。

バッテリー節約機能が有効な場合、Windows Task Scheduler のタスクは、そのタスクが次の条件を満たすときにのみトリガーされます。

• コンピューターがアイドル状態の場合にのみタスクを開始する... に設定されていない(タスクが IdleSettings を使用していない)
• 自動メンテナンス中に実行するように設定されていない(タスクが MaintenanceSettings を使用していない)
• ユーザーがログオンしているときのみ実行する に設定されている(タスクの LogonType が TASK_LOGON_INTERACTIVE_TOKEN または TASK_LOGON_GROUP)

その他のトリガーはすべて、バッテリー節約機能がオフになるまで遅延されます。アプリケーションでバッテリー節約機能の状態にアクセスする方法の詳細については、SYSTEM_POWER_STATUS を参照してください。バッテリー節約機能に関する一般的な情報については、バッテリー節約機能(ハードウェアコンポーネントガイドライン) を参照してください。

例

このインターフェイスの詳細とコード例については、Time Trigger Example (C++) を参照してください。

実行コマンドまたはコンテキストメニューのいずれかを使用してタスクを開始できることを示す Boolean 値を取得または設定します。(Get)

このプロパティが True に設定されている場合、タスクはトリガーがタスクを開始するタイミングとは無関係に開始できます。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの AllowStartOnDemand 要素で指定されます。

実行コマンドまたはコンテキストメニューのいずれかを使用してタスクを開始できることを示す Boolean 値を取得または設定します。(Put)

このプロパティが True に設定されている場合、タスクはトリガーがタスクを開始するタイミングとは無関係に開始できます。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの AllowStartOnDemand 要素で指定されます。

Task Scheduler がタスクの再起動を試みる期間を指定する値を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Interval 要素で指定されます。

Task Scheduler がタスクの再起動を試みる期間を指定する値を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Interval 要素で指定されます。

Task Scheduler がタスクの再起動を試みる回数を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Count 要素で指定されます。

Task Scheduler がタスクの再起動を試みる回数を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Count 要素で指定されます。

Task Scheduler がタスクの複数のインスタンスをどのように扱うかを定義するポリシーを取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの MultipleInstancesPolicy 要素で指定されます。

Task Scheduler がタスクの複数のインスタンスをどのように扱うかを定義するポリシーを取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの MultipleInstancesPolicy 要素で指定されます。

コンピューターがバッテリー電源に切り替わる場合にタスクを停止することを示す Boolean 値を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの StopIfGoingOnBatteries 要素で指定されます。

コンピューターがバッテリー電源に切り替わる場合にタスクを停止することを示す Boolean 値を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの StopIfGoingOnBatteries 要素で指定されます。

コンピューターがバッテリー電源で動作している場合にタスクを開始しないことを示す Boolean 値を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの DisallowStartIfOnBatteries 要素で指定されます。

コンピューターがバッテリー電源で動作している場合にタスクを開始しないことを示す Boolean 値を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの DisallowStartIfOnBatteries 要素で指定されます。

Task Scheduler サービスが TerminateProcess を使用してタスクを終了できることを示す Boolean 値を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの AllowHardTerminate 要素で指定されます。

Task Scheduler サービスが TerminateProcess を使用してタスクを終了できることを示す Boolean 値を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの AllowHardTerminate 要素で指定されます。

スケジュールされた時刻を過ぎた後の任意の時点で Task Scheduler がタスクを開始できることを示す Boolean 値を取得または設定します。(Get)

このプロパティは、終了境界を持つ時間ベースのタスク、または無限に繰り返すように設定された時間ベースのタスクにのみ適用されます。

(StartWhenAvailable プロパティが True に設定されているために)スケジュールされた時刻を過ぎてから開始されるタスクは、Task Scheduler サービスのタスクキューにキューイングされ、遅延後に開始されます。既定の遅延は 10 分です。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの StartWhenAvailable 要素で指定されます。

スケジュールされた時刻を過ぎた後の任意の時点で Task Scheduler がタスクを開始できることを示す Boolean 値を取得または設定します。(Put)

このプロパティは、終了境界を持つ時間ベースのタスク、または無限に繰り返すように設定された時間ベースのタスクにのみ適用されます。

(StartWhenAvailable プロパティが True に設定されているために)スケジュールされた時刻を過ぎてから開始されるタスクは、Task Scheduler サービスのタスクキューにキューイングされ、遅延後に開始されます。既定の遅延は 10 分です。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの StartWhenAvailable 要素で指定されます。

タスク設定の XML 形式の定義を取得または設定します。(Get)

タスク設定の XML 形式の定義を取得または設定します。(Put)

ネットワークが利用可能な場合にのみ Task Scheduler がタスクを実行することを示す Boolean 値を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの RunOnlyIfNetworkAvailable 要素で指定されます。

ネットワークが利用可能な場合にのみ Task Scheduler がタスクを実行することを示す Boolean 値を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの RunOnlyIfNetworkAvailable 要素で指定されます。

タスクの完了に許可される時間を取得または設定します。(Get)

この文字列の形式は PnYnMnDTnHnMnS です。ここで nY は年数、nM は月数、nD は日数、'T' は日付/時刻の区切り文字、nH は時間数、nM は分数、nS は秒数を表します(たとえば、PT5M は 5 分を、P1M4DT2H5M は 1 か月、4 日、2 時間、5 分を指定します)。PT0S を指定すると、タスクを無期限に実行できるようになります。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの ExecutionTimeLimit 要素で指定されます。

タスクの完了に許可される時間を取得または設定します。(Put)

この文字列の形式は PnYnMnDTnHnMnS です。ここで nY は年数、nM は月数、nD は日数、'T' は日付/時刻の区切り文字、nH は時間数、nM は分数、nS は秒数を表します(たとえば、PT5M は 5 分を、P1M4DT2H5M は 1 か月、4 日、2 時間、5 分を指定します)。PT0S を指定すると、タスクを無期限に実行できるようになります。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの ExecutionTimeLimit 要素で指定されます。

タスクが有効であることを示す Boolean 値を取得または設定します。この設定が True の場合にのみタスクを実行できます。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Enabled (settingsType) 要素で指定されます。

タスクが期限切れになった後、Task Scheduler がタスクを削除するまでに待機する時間を取得または設定します。(Get)

タスクは、そのタスクに関連付けられたすべてのトリガーの終了境界を超えると期限切れになります。トリガーの終了境界は、すべてのトリガーインターフェイスが継承する EndBoundary プロパティで指定されます。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの DeleteExpiredTaskAfter (settingsType) 要素で指定されます。

タスクが期限切れになった後、Task Scheduler がタスクを削除するまでに待機する時間を取得または設定します。(Put)

タスクは、そのタスクに関連付けられたすべてのトリガーの終了境界を超えると期限切れになります。トリガーの終了境界は、すべてのトリガーインターフェイスが継承する EndBoundary プロパティで指定されます。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの DeleteExpiredTaskAfter (settingsType) 要素で指定されます。

タスクの優先度レベルを取得または設定します。(Get)

優先度レベル 0 が最も高い優先度で、優先度レベル 10 が最も低い優先度です。既定値は 7 です。優先度レベル 7 と 8 はバックグラウンドタスクに使用され、優先度レベル 4、5、6 はインタラクティブなタスクに使用されます。

タスクのアクションは、Priority Class 値に基づく優先度を持つプロセスで開始されます。COM ハンドラー、メッセージボックス、電子メールのタスクアクションには、Priority Level 値(スレッド優先度)が使用されます。Priority Class 値と Priority Level 値の詳細については、Scheduling Priorities を参照してください。次の表は、priority パラメーターに指定できる値と、対応する Priority Class 値および Priority Level 値の一覧です。

タスクの priority	Priority Class	Priority Level
0	REALTIME_PRIORITY_CLASS	THREAD_PRIORITY_TIME_CRITICAL
1	HIGH_PRIORITY_CLASS	THREAD_PRIORITY_HIGHEST
2	ABOVE_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_ABOVE_NORMAL
3	ABOVE_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_ABOVE_NORMAL
4	NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_NORMAL
5	NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_NORMAL
6	NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_NORMAL
7	BELOW_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_BELOW_NORMAL
8	BELOW_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_BELOW_NORMAL
9	IDLE_PRIORITY_CLASS	THREAD_PRIORITY_LOWEST
10	IDLE_PRIORITY_CLASS	THREAD_PRIORITY_IDLE

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Priority (settingsType) 要素で指定されます。

タスクの優先度レベルを取得または設定します。(Put)

優先度レベル 0 が最も高い優先度で、優先度レベル 10 が最も低い優先度です。既定値は 7 です。優先度レベル 7 と 8 はバックグラウンドタスクに使用され、優先度レベル 4、5、6 はインタラクティブなタスクに使用されます。

タスクのアクションは、Priority Class 値に基づく優先度を持つプロセスで開始されます。COM ハンドラー、メッセージボックス、電子メールのタスクアクションには、Priority Level 値(スレッド優先度)が使用されます。Priority Class 値と Priority Level 値の詳細については、Scheduling Priorities を参照してください。この値はメモリ優先度にも影響します(MEMORY_PRIORITY_INFORMATION を参照)。次の表は、priority パラメーターに指定できる値と、対応する Priority Class 値および Priority Level 値の一覧です。

タスクの priority	Priority Class	Priority Level
0	REALTIME_PRIORITY_CLASS	THREAD_PRIORITY_TIME_CRITICAL
1	HIGH_PRIORITY_CLASS	THREAD_PRIORITY_HIGHEST
2	ABOVE_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_ABOVE_NORMAL
3	ABOVE_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_ABOVE_NORMAL
4	NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_NORMAL
5	NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_NORMAL
6	NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_NORMAL
7	BELOW_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_BELOW_NORMAL
8	BELOW_NORMAL_PRIORITY_CLASS	THREAD_PRIORITY_BELOW_NORMAL
9	IDLE_PRIORITY_CLASS	THREAD_PRIORITY_LOWEST
10	IDLE_PRIORITY_CLASS	THREAD_PRIORITY_IDLE

タスク優先度 4 はメモリ優先度 MEMORY_PRIORITY_NORMAL(5) に、5 は MEMORY_PRIORITY_BELOW_NORMAL(4) に、6 は MEMORY_PRIORITY_MEDIUM(3) に対応します。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Priority (settingsType) 要素で指定されます。

タスクが互換性を持つ Task Scheduler のバージョンを示す整数値を取得または設定します。(Get)

Compatibility プロパティを通じて設定されるタスクの互換性は、タスクを Windows XP、Windows Server 2003、または Windows 2000 のコンピューターからアクセスまたは変更する必要がある場合にのみ TASK_COMPATIBILITY_V1 に設定してください。それ以外の場合は、タスクがより多くの機能を利用できるため、Task Scheduler 2.0 の互換性を使用することをお勧めします。

AT コマンドと互換性のあるタスクは、時間トリガーを 1 つだけ持つことができます。

Task Scheduler 1.0 と互換性のあるタスクは、時間トリガー、ログオントリガー、またはブートトリガーのみを持つことができ、実行可能アクションのみを持つことができます。

タスクの互換性の詳細については、What's New in Task Scheduler および Tasks を参照してください。

タスクが互換性を持つ Task Scheduler のバージョンを示す整数値を取得または設定します。(Put)

Compatibility プロパティを通じて設定されるタスクの互換性は、タスクを Windows XP、Windows Server 2003、または Windows 2000 のコンピューターからアクセスまたは変更する必要がある場合にのみ TASK_COMPATIBILITY_V1 に設定してください。それ以外の場合は、タスクがより多くの機能を利用できるため、Task Scheduler 2.0 の互換性を使用することをお勧めします。

AT コマンドと互換性のあるタスクは、時間トリガーを 1 つだけ持つことができます。

Task Scheduler 1.0 と互換性のあるタスクは、時間トリガー、ログオントリガー、またはブートトリガーのみを持つことができ、実行可能アクションのみを持つことができます。

タスクの互換性の詳細については、What's New in Task Scheduler および Tasks を参照してください。

タスクが UI に表示されないことを示す Boolean 値を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Hidden (settingsType) 要素で指定されます。

タスクが UI に表示されないことを示す Boolean 値を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの Hidden (settingsType) 要素で指定されます。

コンピューターがアイドル状態のときに Task Scheduler がどのようにタスクを実行するかを指定する情報を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの IdleSettings 要素で指定されます。

バッテリー節約機能が有効な場合、Windows Task Scheduler のタスクは、そのタスクが次の条件を満たすときにのみトリガーされます。

• コンピューターがアイドル状態の場合にのみタスクを開始する... に設定されていない(タスクが IdleSettings を使用していない)
• 自動メンテナンス中に実行するように設定されていない(タスクが MaintenanceSettings を使用していない)
• ユーザーがログオンしているときのみ実行する に設定されている(タスクの LogonType が TASK_LOGON_INTERACTIVE_TOKEN または TASK_LOGON_GROUP)

その他のトリガーはすべて、バッテリー節約機能がオフになるまで遅延されます。アプリケーションでバッテリー節約機能の状態にアクセスする方法の詳細については、SYSTEM_POWER_STATUS を参照してください。バッテリー節約機能に関する一般的な情報については、バッテリー節約機能(ハードウェアコンポーネントガイドライン) を参照してください。

コンピューターがアイドル状態のときに Task Scheduler がどのようにタスクを実行するかを指定する情報を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの IdleSettings 要素で指定されます。

バッテリー節約機能が有効な場合、Windows Task Scheduler のタスクは、そのタスクが次の条件を満たすときにのみトリガーされます。

• コンピューターがアイドル状態の場合にのみタスクを開始する... に設定されていない(タスクが IdleSettings を使用していない)
• 自動メンテナンス中に実行するように設定されていない(タスクが MaintenanceSettings を使用していない)
• ユーザーがログオンしているときのみ実行する に設定されている(タスクの LogonType が TASK_LOGON_INTERACTIVE_TOKEN または TASK_LOGON_GROUP)

その他のトリガーはすべて、バッテリー節約機能がオフになるまで遅延されます。アプリケーションでバッテリー節約機能の状態にアクセスする方法の詳細については、SYSTEM_POWER_STATUS を参照してください。バッテリー節約機能に関する一般的な情報については、バッテリー節約機能(ハードウェアコンポーネントガイドライン) を参照してください。

コンピューターがアイドル状態の場合にのみ Task Scheduler がタスクを実行することを示す Boolean 値を取得または設定します。(Get)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの RunOnlyIfIdle 要素で指定されます。

コンピューターがアイドル状態の場合にのみ Task Scheduler がタスクを実行することを示す Boolean 値を取得または設定します。(Put)

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの RunOnlyIfIdle 要素で指定されます。

タスクの実行時刻になったときに Task Scheduler がコンピューターをスリープ解除し、タスクが完了するまでコンピューターをスリープさせないことを示す Boolean 値を取得または設定します。(Get)

タスクのこのプロパティが true に設定されていて、コンピューターが既にスリープ解除されている状態でトリガーされた場合、Task Scheduler はタスクの実行が完了するまでコンピューターをスリープさせないよう要求します。

Task Scheduler サービスがタスクを実行するためにコンピューターをスリープ解除した場合、コンピューターがスリープまたは休止状態でなくなっても画面はオフのままになることがあります。Windows Vista がユーザーがコンピューターの使用に戻ったことを検出すると、画面がオンになります。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの WakeToRun 要素で指定されます。

タスクの実行時刻になったときに Task Scheduler がコンピューターをスリープ解除し、タスクが完了するまでコンピューターをスリープさせないことを示す Boolean 値を取得または設定します。(Put)

タスクのこのプロパティが true に設定されていて、コンピューターが既にスリープ解除されている状態でトリガーされた場合、Task Scheduler はタスクの実行が完了するまでコンピューターをスリープさせないよう要求します。

Task Scheduler サービスがタスクを実行するためにコンピューターをスリープ解除した場合、コンピューターがスリープまたは休止状態でなくなっても画面はオフのままになることがあります。Windows Vista がユーザーがコンピューターの使用に戻ったことを検出すると、画面がオンになります。

タスクの XML を読み書きする場合、この設定は Task Scheduler スキーマの WakeToRun 要素で指定されます。

ネットワークプロファイルの識別子と名前を含むネットワーク設定オブジェクトを取得または設定します。(Get)

ネットワークプロファイルの識別子と名前を含むネットワーク設定オブジェクトを取得または設定します。(Put)

#define global IID_ITaskSettings "{8FD4711D-2D02-4C8C-87E3-EFF699DE127E}"
#usecom global ITaskSettings IID_ITaskSettings "{}"
#comfunc global ITaskSettings_get_AllowDemandStart            7 var
#comfunc global ITaskSettings_put_AllowDemandStart            8 int
#comfunc global ITaskSettings_get_RestartInterval             9 var
#comfunc global ITaskSettings_put_RestartInterval             10 wstr
#comfunc global ITaskSettings_get_RestartCount                11 var
#comfunc global ITaskSettings_put_RestartCount                12 int
#comfunc global ITaskSettings_get_MultipleInstances           13 var
#comfunc global ITaskSettings_put_MultipleInstances           14 int
#comfunc global ITaskSettings_get_StopIfGoingOnBatteries      15 var
#comfunc global ITaskSettings_put_StopIfGoingOnBatteries      16 int
#comfunc global ITaskSettings_get_DisallowStartIfOnBatteries  17 var
#comfunc global ITaskSettings_put_DisallowStartIfOnBatteries  18 int
#comfunc global ITaskSettings_get_AllowHardTerminate          19 var
#comfunc global ITaskSettings_put_AllowHardTerminate          20 int
#comfunc global ITaskSettings_get_StartWhenAvailable          21 var
#comfunc global ITaskSettings_put_StartWhenAvailable          22 int
#comfunc global ITaskSettings_get_XmlText                     23 var
#comfunc global ITaskSettings_put_XmlText                     24 wstr
#comfunc global ITaskSettings_get_RunOnlyIfNetworkAvailable   25 var
#comfunc global ITaskSettings_put_RunOnlyIfNetworkAvailable   26 int
#comfunc global ITaskSettings_get_ExecutionTimeLimit          27 var
#comfunc global ITaskSettings_put_ExecutionTimeLimit          28 wstr
#comfunc global ITaskSettings_get_Enabled                     29 var
#comfunc global ITaskSettings_put_Enabled                     30 int
#comfunc global ITaskSettings_get_DeleteExpiredTaskAfter      31 var
#comfunc global ITaskSettings_put_DeleteExpiredTaskAfter      32 wstr
#comfunc global ITaskSettings_get_Priority                    33 var
#comfunc global ITaskSettings_put_Priority                    34 int
#comfunc global ITaskSettings_get_Compatibility               35 var
#comfunc global ITaskSettings_put_Compatibility               36 int
#comfunc global ITaskSettings_get_Hidden                      37 var
#comfunc global ITaskSettings_put_Hidden                      38 int
#comfunc global ITaskSettings_get_IdleSettings                39 sptr
#comfunc global ITaskSettings_put_IdleSettings                40 sptr
#comfunc global ITaskSettings_get_RunOnlyIfIdle               41 var
#comfunc global ITaskSettings_put_RunOnlyIfIdle               42 int
#comfunc global ITaskSettings_get_WakeToRun                   43 var
#comfunc global ITaskSettings_put_WakeToRun                   44 int
#comfunc global ITaskSettings_get_NetworkSettings             45 sptr
#comfunc global ITaskSettings_put_NetworkSettings             46 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。