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])

所有其他觸發程式都會延遲，直到省電模式關閉為止。 如需在應用程式中存取省電模式狀態的詳細資訊，請參閱 SYSTEM_POWER_STATUS。 如需省電模式的一般資訊，請參閱 硬體元件指導方針中的省電 () 。

範例

如需此介面的詳細資訊和程式代碼範例，請參閱 時間觸發程式範例 (C++) 。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	taskschd.h

另請參閱

IIdleSettings

INetworkSettings

ITaskDefinition