IRepetitionPattern 接口 (taskschd.h)

定义任务运行的频率,以及任务启动后重复模式的时长。

继承

IRepetitionPattern 接口继承自 IDispatch 接口。

方法

IRepetitionPattern 接口具有以下方法。

 
IRepetitionPattern::get_Duration

获取或设置模式的重复时长。 (获取)
IRepetitionPattern::get_Interval

获取或设置每次重启任务之间的时间。 (获取)
IRepetitionPattern::get_StopAtDurationEnd

获取或设置一个布尔值,该值指示任务的运行实例是否在重复模式持续时间结束时停止。 (获取)
IRepetitionPattern::p ut_Duration

获取或设置模式的重复时长。 (放置)
IRepetitionPattern::p ut_Interval

获取或设置每次重启任务之间的时间。 (放置)
IRepetitionPattern::p ut_StopAtDurationEnd

获取或设置一个布尔值,该值指示任务的运行实例是否在重复模式持续时间结束时停止。 (放置)

注解

如果指定任务的重复持续时间,则还必须指定重复间隔。

如果注册的任务包含一个触发器,其重复间隔等于一分钟,重复持续时间等于四分钟,则该任务将启动五次。 可通过以下模式定义五个重复。

  1. 任务从第一分钟的开头开始。
  2. 下一个任务从第一分钟结束时开始。
  3. 下一个任务从第二分钟结束时开始。
  4. 下一个任务在第三分钟结束时开始。
  5. 下一个任务在第四分钟结束时开始。
Windows Server 2003、Windows XP 和 Windows 2000: 如果注册的任务包含一个触发器,其重复间隔等于一分钟,重复持续时间等于四分钟,则该任务将启动四次。

读取或写入任务的 XML 时,使用任务计划程序架构的 Repetition 元素指定重复模式。

示例

有关此属性的详细信息和示例代码,请参阅 每日触发器示例 (C++)

要求

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

另请参阅

ITrigger

ITrigger 的 Repetition 属性

任务计划程序

任务计划程序接口