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 gatilho e a interface COM IPersistFile fornece um método Save para salvar o novo gatilho em 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 o 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 "Tarefa de Teste".)
3. Chame CreateTrigger para criar um objeto de gatilho. (Observe que CreateTrigger é herdado de IScheduledWorkItem.)
4. Defina uma estrutura TASK_TRIGGER . Observe que os membros wBeginDay, wBeginMonth e wBeginYear de TASK_TRIGGER devem ser definidos como um dia, mês e ano válidos, respectivamente.
5. Chame ITaskTrigger::SetTrigger para definir os critérios de gatilho.
6. Salve a tarefa com o novo gatilho no disco usando IPersistFile::Save. (A interface IPersistFile é uma interface COM padrão compatível com a interface ITask .)
7. Chame Release para liberar todos os recursos. (Observe que Release é um método IUnknown herdado por ITask.)

Para obter um exemplo de código de	Consulte
Criando um novo gatilho para uma tarefa existente	Exemplo de código C/C++: criando um gatilho de tarefa

 

Tópicos relacionados

Exemplos do Agendador de Tarefas 1.0