Criando um novo gatilho

Para criar um gatilho você deve usar três interfaces. IScheduledWorkItem fornece o método IScheduledWorkItem::CreateTrigger para criar o objeto trigger, ITaskTrigger fornece o método ITaskTrigger::SetTrigger para definir os critérios para o trigger e a interface COM IPersistFile fornece um método Save para salvar o novo trigger no disco.

O procedimento a seguir descreve como criar um novo gatilho.

Para criar um novo gatilho

1. Chame CoInitialize para inicializar a biblioteca COM e CoCreateInstance para obter um objeto Agendador de Tarefas. (Este exemplo pressupõe que o serviço Agendador de Tarefas esteja em execução.)
2. Chame ITaskScheduler::Activate para obter a interface ITask do objeto de tarefa. (Observe que este exemplo obtém a tarefa "Test Task".)
3. Chame CreateTrigger para criar um objeto trigger. (Observe que CreateTrigger é herdado de IScheduledWorkItem.)
4. Defina uma estrutura TASK_TRIGGER. Observe que os membros wBeginDay, wBeginMonth e wBeginYear do TASK_TRIGGER devem ser definidos como um dia, mês e um ano válidos, respectivamente.
5. Chame ITaskTrigger::SetTrigger para definir os critérios de gatilho.
6. Salve no disco a tarefa com o novo gatilho usando IPersistFile::Save. (A interface IPersistFile é uma interface COM padrão suportada pela interface ITask.)
7. Ligue para Release para liberar todos os recursos. (Observe que Release é um método IUnknown herdado por ITask.)

Tópicos relacionados

Exemplos do Agendador de Tarefas 1.0