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

示例

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

要求

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

另请参阅

IIdleSettings

INetworkSettings

ITaskDefinition