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. Essa 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.
APIs de objeto para desenvolvimento de scripts
Para obter mais informações sobre os métodos e as propriedades dos objetos que são usados para especificar gatilhos, consulte:
- TaskDefinition
- Triggercollection
- Gatilho
- BootTrigger
- DailyTrigger
- EventTrigger
- IdleTrigger
- LogonTrigger
- MonthlyDOWTrigger
- MonthlyTrigger
- RegistrationTrigger
- TimeTrigger
- WeeklyTrigger
APIs de interfaces para desenvolvimento em C++
Para obter mais informações sobre os métodos e as propriedades das interfaces usadas para especificar gatilhos, consulte:
- ITaskDefinition
- ITriggerCollection
- ITrigger
- IBootTrigger
- IDailyTrigger
- IEventTrigger
- IIdleTrigger
- ILogonTrigger
- IMonthlyDOWTrigger
- IMonthlyTrigger
- IRegistrationTrigger
- ITimeTrigger
- IWeeklyTrigger
Interfaces de gatilho do Agendador de Tarefas 1.0
Os aplicativos existentes 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 estã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. A interface IScheduledWorkItem é usada 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.
A interface IScheduledWorkItem 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 excluir gatilhos.
Depois que o objeto de gatilho 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.
Tópicos relacionados