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.
- Uma tarefa começa no início do primeiro minuto.
- A próxima tarefa começa no final do primeiro minuto.
- A próxima tarefa começa no final do segundo minuto.
- A próxima tarefa começa no final do terceiro minuto.
- A próxima tarefa começa no final do quarto minuto.
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 |