ITaskSettings 介面 (taskschd.h)
提供工作排程器服務用來執行工作的設定。
繼承
ITaskSettings 介面繼承自 IDispatch 介面。
方法
ITaskSettings 介面具有這些方法。
ITaskSettings::get_AllowDemandStart 取得或設定布爾值,指出可以使用 [執行] 命令或操作功能表來啟動工作。 (取得) |
ITaskSettings::get_AllowHardTerminate 取得或設定布爾值,指出工作可能由工作排程器服務使用 TerminateProcess 終止。 (取得) |
ITaskSettings::get_Compatibility 取得或設定整數值,指出工作與哪個工作排程器版本相容。 (取得) |
ITaskSettings::get_DeleteExpiredTaskAfter 取得或設定工作排程器在到期后刪除工作之前等待的時間量。 (取得) |
ITaskSettings::get_DisallowStartIfOnBatteries 取得或設定布爾值,指出當計算機在電池上執行時,將不會啟動工作。 (取得) |
ITaskSettings::get_Enabled 取得或設定布爾值,指出已啟用工作。 只有在此設定為 True 時,才能執行工作。 |
ITaskSettings::get_ExecutionTimeLimit 取得或設定允許完成工作的時間量。 (取得) |
ITaskSettings::get_Hidden 取得或設定布爾值,指出工作不會顯示在UI中。 (取得) |
ITaskSettings::get_IdleSettings 取得或設定資訊,指定當計算機處於閑置狀況時,工作排程器執行工作的方式。 (取得) |
ITaskSettings::get_MultipleInstances 取得或設定原則,定義工作排程器如何處理工作的多個實例。 (取得) |
ITaskSettings::get_NetworkSettings 取得或設定包含網路配置檔識別碼和名稱的網路設定物件。 (取得) |
ITaskSettings::get_Priority 取得或設定工作的優先順序層級。 (取得) |
ITaskSettings::get_RestartCount 取得或設定工作排程器嘗試重新啟動工作的次數。 (取得) |
ITaskSettings::get_RestartInterval 取得或設定值,指定工作排程器嘗試重新啟動工作的時間長度。 (取得) |
ITaskSettings::get_RunOnlyIfIdle 取得或設定布爾值,指出只有在計算機處於閑置狀況時,工作排程器才會執行工作。 (取得) |
ITaskSettings::get_RunOnlyIfNetworkAvailable 取得或設定布爾值,指出工作排程器只會在網路可用時執行工作。 (取得) |
ITaskSettings::get_StartWhenAvailable 取得或設定布爾值,這個值表示工作排程器可以在其排程時間過後隨時啟動工作。 (取得) |
ITaskSettings::get_StopIfGoingOnBatteries 取得或設定 Boolean 值,指出如果電腦進入電池,工作將會停止。 (取得) |
ITaskSettings::get_WakeToRun 取得或設定 Boolean 值,指出工作排程器會在執行工作時喚醒電腦,並讓電腦保持喚醒,直到工作完成為止。 (取得) |
ITaskSettings::get_XmlText 取得或設定工作設定的 XML 格式定義。 (取得) |
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 取得或設定 Boolean 值,指出如果電腦進入電池,工作將會停止。 (Put) |
ITaskSettings::p ut_WakeToRun 取得或設定 Boolean 值,指出工作排程器會在執行工作時喚醒電腦,並讓電腦保持喚醒,直到工作完成為止。 (Put) |
ITaskSettings::p ut_XmlText 取得或設定工作設定的 XML 格式定義。 (Put) |
備註
根據預設,工作會在開始執行之後 72 小時停止。 您可以變更 ExecutionTimeLimit 設定來變更此設定。
讀取或寫入工作的 XML 時,工作設定定義於工作排程器架構的 Settings 元素中。
當省電模式開啟時,只有在工作為時,才會觸發 Windows 工作排程器工作:
- 只有當計算機閑置時,才會設定為 [啟動] 工作... (工作不使用 IdleSettings)
- 未設定為在自動維護期間執行 (工作不會使用 MaintenanceSettings)
- 只有在使用者登入 (工作 LogonType 時,才會設定為 [執行TASK_LOGON_INTERACTIVE_TOKEN] 或 [TASK_LOGON_GROUP])
範例
如需此介面的詳細資訊和程式代碼範例,請參閱 時間觸發程式範例 (C++) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | taskschd.h |