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)
示例
有关详细信息和此接口的代码示例,请参阅 时间触发器示例 (C++) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | taskschd.h |