Partilhar via

Interfaces de gatilho

As APIs usadas para gerenciar gatilhos variam dependendo da versão do Agendador de Tarefas. No entanto, em ambos os casos, essas APIs permitem que você crie novos gatilhos, recupere e atualize gatilhos existentes e exclua gatilhos que não são mais necessários.

Os aplicativos desenvolvidos usando o Agendador de Tarefas 2.0 podem usar objetos e interfaces para criar, recuperar, modificar e excluir os gatilhos de uma tarefa.

Na ilustração a seguir, uma tarefa especifica uma coleção de gatilhos usando sua propriedade Triggers. Esta coleção contém uma ou mais APIs de gatilho individuais com cada API especificando um tipo de gatilho específico. Por exemplo, na ilustração abaixo, a coleção de gatilhos contém um gatilho de inicialização, um gatilho de logon e um gatilho diário.

interfaces de gatilho do Agendador de Tarefas 2.0

APIs de objeto para desenvolvimento de scripts

Para obter mais informações sobre os métodos e propriedades dos objetos usados para especificar gatilhos, consulte:

  • TaskDefinition
  • TriggerCollection
  • Gatilho
  • BootTrigger
  • DailyTrigger
  • EventTrigger
  • IdleTrigger
  • LogonTrigger
  • MonthlyDOWTrigger
  • MonthlyTrigger
  • RegistrationTrigger
  • TimeTrigger
  • WeeklyTrigger

APIs de interfaces para desenvolvimento C++

Para obter mais informações sobre os métodos e propriedades das interfaces que são usadas para especificar gatilhos, consulte:

Interfaces de gatilho do Agendador de Tarefas 1.0

Os aplicativos existentes que são desenvolvidos usando o Agendador de Tarefas 1.0 podem usar os métodos disponíveis nas interfaces do Agendador de Tarefas 1.0 para criar, recuperar, modificar e excluir os gatilhos de um item de trabalho. No entanto, observe que todas as interfaces, enumerações e estruturas do Agendador de Tarefas 1.0 são obsoletas e não devem ser usadas para o desenvolvimento de novos aplicativos.

As duas interfaces usadas para fazer isso são mostradas na ilustração a seguir. O interface de IScheduledWorkItem é usado para gerenciar todos os gatilhos associados a um item de trabalho (esse gerenciamento inclui a criação de um novo gatilho para o item de trabalho). A interface ITaskTrigger é usada para gerenciar um gatilho específico.

interfaces de gatilho do agendador de tarefas 1.0

A interfaceIScheduledWorkItem fornece métodos para criar um novo gatilho para um item de trabalho, recuperar o número de gatilhos associados a um item de trabalho, recuperar as estruturas de gatilho associadas ao item de trabalho, recuperar cadeias de caracteres de gatilho associadas ao item de trabalho, e para excluir gatilhos.

Quando o objeto trigger estiver disponível, você poderá usar a interface ITaskTrigger para recuperar a estrutura do gatilho e a cadeia de caracteres do gatilho e definir os critérios usados para disparar o gatilho. Essa interface é usada somente quando você está trabalhando com um objeto de gatilho de tarefa .

Acionadores de Tarefas

tipos de gatilho

Estruturas de gatilho

 

 

  • Last updated on