Interfaces de déclencheur
Les API utilisées pour gérer les déclencheurs varient en fonction de la version du Planificateur de tâches. Toutefois, dans les deux cas, ces API vous permettent de créer des déclencheurs, de récupérer et de mettre à jour des déclencheurs existants et de supprimer des déclencheurs qui ne sont plus nécessaires.
Les applications développées à l’aide du Planificateur de tâches 2.0 peuvent utiliser des objets et des interfaces pour créer, récupérer, modifier et supprimer les déclencheurs d’une tâche.
Dans l’illustration suivante, une tâche spécifie une collection de déclencheurs à l’aide de sa propriété Triggers. Cette collection contient une ou plusieurs API de déclencheur individuelles, chaque API spécifiant un type de déclencheur spécifique. Par exemple, dans l’illustration ci-dessous, la collection de déclencheurs contient un déclencheur de démarrage, un déclencheur d’ouverture de session et un déclencheur quotidien.
API d’objet pour le développement de scripts
Pour plus d’informations sur les méthodes et les propriétés des objets utilisés pour spécifier des déclencheurs, consultez :
- TaskDefinition
- TriggerCollection
- Déclencheur
- BootTrigger
- DailyTrigger
- EventTrigger
- IdleTrigger
- LogonTrigger
- MonthlyDOWTrigger
- MonthlyTrigger
- RegistrationTrigger
- TimeTrigger
- WeeklyTrigger
API d’interfaces pour le développement C++
Pour plus d’informations sur les méthodes et les propriétés des interfaces utilisées pour spécifier des déclencheurs, consultez :
- ITaskDefinition
- ITriggerCollection
- ITrigger
- IBootTrigger
- IDailyTrigger
- IEventTrigger
- IIdleTrigger
- ILogonTrigger
- IMonthlyDOWTrigger
- IMonthlyTrigger
- IRegistrationTrigger
- ITimeTrigger
- IWeeklyTrigger
Interfaces de déclencheur du Planificateur de tâches 1.0
Les applications existantes développées à l’aide du Planificateur de tâches 1.0 peuvent utiliser les méthodes disponibles à partir des interfaces du Planificateur de tâches 1.0 pour créer, récupérer, modifier et supprimer les déclencheurs d’un élément de travail. Toutefois, notez que toutes les interfaces, énumérations et structures du Planificateur de tâches 1.0 sont obsolètes et ne doivent pas être utilisées pour le développement de nouvelles applications.
Les deux interfaces utilisées pour cela sont illustrées dans l’illustration suivante. L’interface IScheduledWorkItem est utilisée pour gérer tous les déclencheurs associés à un élément de travail (cette gestion inclut la création d’un déclencheur pour l’élément de travail). L’interface ITaskTrigger est utilisée pour gérer un déclencheur spécifique.
L’interface IScheduledWorkItem fournit des méthodes permettant de créer un déclencheur pour un élément de travail, de récupérer le nombre de déclencheurs associés à un élément de travail, de récupérer les structures de déclencheur associées à l’élément de travail, de récupérer les chaînes de déclencheur associées à l’élément de travail et de supprimer des déclencheurs.
Une fois l’objet déclencheur disponible, vous pouvez utiliser l’interface ITaskTrigger pour récupérer la structure du déclencheur et la chaîne du déclencheur et définir les critères utilisés pour déclencher le déclencheur. Cette interface est utilisée uniquement lorsque vous travaillez avec un objet déclencheur de tâche.
Rubriques connexes