Интерфейс IRepetitionPattern (taskschd.h)

  • Статья

Определяет, как часто выполняется задача и как долго повторяется шаблон повторения после запуска задачи.

Наследование

Интерфейс IRepetitionPattern наследуется от интерфейса IDispatch.

Методы

Интерфейс IRepetitionPattern содержит следующие методы.

 
IRepetitionPattern::get_Duration

Возвращает или задает время повтора шаблона. (Получить)
IRepetitionPattern::get_Interval

Возвращает или задает интервал времени между каждым перезапуском задачи. (Получить)
IRepetitionPattern::get_StopAtDurationEnd

Возвращает или задает логическое значение, указывающее, останавливается ли выполняющийся экземпляр задачи в конце длительности шаблона повторения. (Получить)
IRepetitionPattern::p ut_Duration

Возвращает или задает время повтора шаблона. (Put)
IRepetitionPattern::p ut_Interval

Возвращает или задает интервал времени между каждым перезапуском задачи. (Put)
IRepetitionPattern::p ut_StopAtDurationEnd

Возвращает или задает логическое значение, указывающее, останавливается ли выполняющийся экземпляр задачи в конце длительности шаблона повторения. (Put)

Комментарии

Если вы указываете длительность повторения для задачи, необходимо также указать интервал повторения.

Если зарегистрировать задачу, содержащую триггер с интервалом повторения, равным одной минуте, и длительностью повторения, равной четырем минутам, задача будет запущена пять раз. Пять повторений можно определить по следующему шаблону.

  1. Задача начинается в начале первой минуты.
  2. Следующая задача начинается в конце первой минуты.
  3. Следующая задача начинается в конце второй минуты.
  4. Следующая задача начинается в конце третьей минуты.
  5. Следующая задача начинается в конце четвертой минуты.
Windows Server 2003, Windows XP и Windows 2000: Если зарегистрировать задачу, содержащую триггер с интервалом повторения, равным одной минуте, и длительностью повторения, равной четырем минутам, задача будет запущена четыре раза.

При чтении или записи XML для задачи шаблон повторения указывается с помощью элемента Повторение схемы планировщика задач.

Примеры

Дополнительные сведения и пример кода для этого свойства см. в разделе Пример ежедневного триггера (C++).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header taskschd.h

См. также раздел

ITrigger

Свойство повторения ITrigger

Планировщик заданий

Интерфейсы планировщика задач