Interfaces de desencadenador
Las API que se usan para administrar desencadenadores varían en función de la versión del Programador de tareas. Sin embargo, en ambos casos, estas API permiten crear nuevos desencadenadores, recuperar y actualizar desencadenadores existentes y eliminar desencadenadores que ya no son necesarios.
Las aplicaciones desarrolladas mediante task Scheduler 2.0 pueden usar objetos e interfaces para crear, recuperar, modificar y eliminar los desencadenadores de una tarea.
En la ilustración siguiente, una tarea especifica una colección de desencadenadores mediante su propiedad Triggers. Esta colección contiene una o varias API de desencadenador individuales con cada API que especifica un tipo de desencadenador específico. Por ejemplo, en la ilustración siguiente, la colección de desencadenadores contiene un desencadenador de arranque, un desencadenador de inicio de sesión y un desencadenador diario.
API de objetos para el desarrollo de scripting
Para obtener más información sobre los métodos y propiedades de los objetos que se usan para especificar desencadenadores, vea:
- TaskDefinition
- TriggerCollection
- Detonante
- BootTrigger
- DailyTrigger
- EventTrigger
- IdleTrigger
- LogonTrigger
- MonthlyDOWTrigger
- MonthlyTrigger
- RegistrationTrigger
- TimeTrigger
- WeeklyTrigger
API de interfaces para el desarrollo de C++
Para obtener más información sobre los métodos y propiedades de las interfaces que se usan para especificar desencadenadores, vea:
- ITaskDefinition
- ITriggerCollection
- ITrigger
- IBootTrigger
- IDailyTrigger
- IEventTrigger
- IIdleTrigger
- ILogonTrigger
- IMonthlyDOWTrigger
- IMonthlyTrigger
- IRegistrationTrigger
- ITimeTrigger
- IWeeklyTrigger
Interfaces de desencadenador del Programador de tareas 1.0
Las aplicaciones existentes desarrolladas mediante el Programador de tareas 1.0 pueden usar los métodos disponibles en las interfaces del Programador de tareas 1.0 para crear, recuperar, modificar y eliminar los desencadenadores de un elemento de trabajo. Sin embargo, tenga en cuenta que todas las interfaces, enumeraciones y estructuras del Programador de tareas 1.0 están obsoletas y no deben usarse para el desarrollo de nuevas aplicaciones.
Las dos interfaces que se usan para hacerlo se muestran en la ilustración siguiente. La interfaz IScheduledWorkItem se usa para administrar todos los desencadenadores asociados a un elemento de trabajo (esta administración incluye la creación de un nuevo desencadenador para el elemento de trabajo). La interfaz ITaskTrigger se usa para administrar un desencadenador específico.
La interfaz IScheduledWorkItem proporciona métodos para crear un nuevo desencadenador para un elemento de trabajo, recuperar el número de desencadenadores asociados a un elemento de trabajo, recuperar las estructuras de desencadenador asociadas al elemento de trabajo, recuperar cadenas de desencadenador asociadas al elemento de trabajo y para eliminar desencadenadores.
Una vez que el objeto de desencadenador está disponible, puede usar la interfaz ITaskTrigger para recuperar la estructura del desencadenador y la cadena del desencadenador y establecer los criterios que se usan para activar el desencadenador. Esta interfaz solo se usa cuando se trabaja con un objeto de desencadenador de tareas.
Temas relacionados