Interface IRepetitionPattern (taskschd.h)

Define a frequência com que a tarefa é executada e por quanto tempo o padrão de repetição é repetido após o início da tarefa.

Herança

A interface IRepetitionPattern herda da interface IDispatch.

Métodos

A interface IRepetitionPattern tem esses métodos.

IRepetitionPattern::get_Duration Obtém ou define por quanto tempo o padrão é repetido. (Obter)
IRepetitionPattern::get_Interval Obtém ou define a quantidade de tempo entre cada reinicialização da tarefa. (Obter)
IRepetitionPattern::get_StopAtDurationEnd Obtém ou define um valor booliano que indica se uma instância em execução da tarefa é interrompida no final da duração do padrão de repetição. (Obter)
IRepetitionPattern::p ut_Duration Obtém ou define por quanto tempo o padrão é repetido. (Put)
IRepetitionPattern::p ut_Interval Obtém ou define a quantidade de tempo entre cada reinicialização da tarefa. (Put)
IRepetitionPattern::p ut_StopAtDurationEnd Obtém ou define um valor booliano que indica se uma instância em execução da tarefa é interrompida no final da duração do padrão de repetição. (Put)

Comentários

Se você especificar uma duração de repetição para uma tarefa, também deverá especificar o intervalo de repetição.

Se você registrar uma tarefa que contém um gatilho com um intervalo de repetição igual a um minuto e uma duração de repetição igual a quatro minutos, a tarefa será iniciada cinco vezes. As cinco repetições podem ser definidas pelo padrão a seguir.

1. Uma tarefa começa no início do primeiro minuto.
2. A próxima tarefa começa no final do primeiro minuto.
3. A próxima tarefa começa no final do segundo minuto.
4. A próxima tarefa começa no final do terceiro minuto.
5. A próxima tarefa começa no final do quarto minuto.

Windows Server 2003, Windows XP e Windows 2000: Se você registrar uma tarefa que contém um gatilho com um intervalo de repetição igual a um minuto e uma duração de repetição igual a quatro minutos, a tarefa será iniciada quatro vezes.

Ao ler ou gravar XML para uma tarefa, o padrão de repetição é especificado usando o elemento Repetition do esquema do Agendador de Tarefas.

Exemplos

Para obter mais informações e código de exemplo para essa propriedade, consulte Exemplo de gatilho diário (C++).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	taskschd.h

Confira também

ITrigger

Propriedade Repetition de ITrigger

Agendador de Tarefas

Interfaces do Agendador de Tarefas