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 获取或设置一个布尔值，该值指示当计算机使用电池时任务将停止。 (获取)
ITaskSettings：：get_WakeToRun 获取或设置一个布尔值，该值指示任务计划程序将在运行任务时唤醒计算机，并使计算机保持唤醒状态，直到任务完成。 (获取)
ITaskSettings：：get_XmlText 获取或设置任务设置的 XML 格式定义。 (获取)
ITaskSettings：:p ut_AllowDemandStart 获取或设置一个布尔值，该值指示可以使用“运行”命令或上下文菜单启动任务。 (放置)
ITaskSettings：:p ut_AllowHardTerminate 获取或设置一个布尔值，该值指示任务计划程序服务可以使用 TerminateProcess 终止任务。 (放置)
ITaskSettings：:p ut_Compatibility 获取或设置一个整数值，该值指示任务与哪个版本的任务计划程序兼容。 (放置)
ITaskSettings：:p ut_DeleteExpiredTaskAfter 获取或设置任务计划程序在过期后删除任务之前等待的时间量。 (放置)
ITaskSettings：:p ut_DisallowStartIfOnBatteries 获取或设置一个布尔值，该值指示如果计算机使用电池运行，则不会启动任务。 (放置)
ITaskSettings：:p ut_ExecutionTimeLimit 获取或设置允许完成任务的时间量。 (放置)
ITaskSettings：:p ut_Hidden 获取或设置一个布尔值，该值指示任务在 UI 中不可见。 (放置)
ITaskSettings：:p ut_IdleSettings 获取或设置信息，该信息指定任务计划程序在计算机处于空闲状态时如何执行任务。 (放置)
ITaskSettings：:p ut_MultipleInstances 获取或设置策略，该策略定义任务计划程序如何处理任务的多个实例。 (放置)
ITaskSettings：:p ut_NetworkSettings 获取或设置包含网络配置文件标识符和名称的网络设置对象。 (放置)
ITaskSettings：:p ut_Priority 获取或设置任务的优先级。 (放置)
ITaskSettings：:p ut_RestartCount 获取或设置任务计划程序尝试重启任务的次数。 (放置)
ITaskSettings：:p ut_RestartInterval 获取或设置一个值，该值指定任务计划程序尝试重启任务的时间长度。 (放置)
ITaskSettings：:p ut_RunOnlyIfIdle 获取或设置一个布尔值，该值指示仅当计算机处于空闲状态时，任务计划程序才会运行任务。 (放置)
ITaskSettings：:p ut_RunOnlyIfNetworkAvailable 获取或设置一个布尔值，该值指示任务计划程序仅在网络可用时运行任务。 (放置)
ITaskSettings：:p ut_StartWhenAvailable 获取或设置一个布尔值，该值指示任务计划程序可以在其计划时间过后随时启动任务。 (放置)
ITaskSettings：:p ut_StopIfGoingOnBatteries 获取或设置一个布尔值，该值指示在计算机使用电池时任务将停止。 (放置)
ITaskSettings：:p ut_WakeToRun 获取或设置一个布尔值，该值指示任务计划程序将在运行任务时唤醒计算机，并保持计算机处于唤醒状态，直到任务完成。 (放置)
ITaskSettings：:p ut_XmlText 获取或设置任务设置的 XML 格式定义。 (放置)

注解

默认情况下，任务将在开始运行 72 小时后停止。 可以通过更改 ExecutionTimeLimit 设置来更改此设置。

读取或写入任务的 XML 时，任务设置在任务计划程序架构的 Settings 元素中定义。

当节电模式处于打开状态时，仅当任务为时，才会触发 Windows 任务计划程序任务：

• 未设置为“仅在计算机空闲时启动任务...”（任务未使用 IdleSettings）
• 未设置为在自动维护期间运行（任务未使用 MaintenanceSettings）
• 设置为 “仅当用户登录时运行” (任务 LogonTypeTASK_LOGON_INTERACTIVE_TOKEN 或 TASK_LOGON_GROUP)

所有其他触发器将延迟到节电模式关闭。 有关在应用程序中访问省电模式的更多信息，请参阅 SYSTEM_POWER_STATUS。 有关节电模式的一般信息，请参阅 ) 的硬件组件指南中的节电模式 (。

示例

有关详细信息和此接口的代码示例，请参阅 时间触发器示例 (C++) 。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	taskschd.h

另请参阅

IIdleSettings

INetworkSettings

ITaskDefinition