Compartilhar via


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

 

Exemplos do Agendador de Tarefas 1.0