Crée un déclencheur pour la tâche.
Syntaxe
HRESULT Create(
[in] TASK_TRIGGER_TYPE2 type,
[out] ITrigger **ppTrigger
);
Paramètres
[in] type
Ce paramètre est défini sur l’une des constantes d’énumération TASK_TRIGGER_TYPE2 suivantes.
| Valeur |
Signification |
-
TASK_TRIGGER_EVENT
- 0
|
Déclenche la tâche lorsqu’un événement spécifique se produit.
|
-
TASK_TRIGGER_TIME
- 1
|
Déclenche la tâche à une heure spécifique de la journée.
|
-
TASK_TRIGGER_DAILY
- 2
|
Déclenche la tâche selon une planification quotidienne. Par exemple, la tâche commence à une heure spécifique chaque jour, tous les autres jours, tous les troisièmes jours, et ainsi de suite.
|
-
TASK_TRIGGER_WEEKLY
- 3
|
Déclenche la tâche selon une planification hebdomadaire. Par exemple, la tâche commence à 8h00 par jour spécifique chaque semaine ou une autre semaine.
|
-
TASK_TRIGGER_MONTHLY
- 4
|
Déclenche la tâche selon une planification mensuelle. Par exemple, la tâche démarre sur des jours spécifiques de mois spécifiques.
|
-
TASK_TRIGGER_MONTHLYDOW
- 5
|
Déclenche la tâche selon une planification mensuelle de jour de semaine. Par exemple, la tâche démarre sur un jour spécifique de la semaine, des semaines du mois et des mois de l’année.
|
-
TASK_TRIGGER_IDLE
- 6
|
Déclenche la tâche lorsque l’ordinateur passe à un état inactif.
|
-
TASK_TRIGGER_REGISTRATION
- 7
|
Déclenche la tâche lorsque la tâche est inscrite.
|
-
TASK_TRIGGER_BOOT
- 8
|
Déclenche la tâche lorsque l’ordinateur démarre.
|
-
TASK_TRIGGER_LOGON
- 9
|
Déclenche la tâche lorsqu’un utilisateur spécifique se connecte.
|
-
TASK_TRIGGER_SESSION_STATE_CHANGE
- 11
|
Déclenche la tâche lorsqu’un état de session spécifique change.
|
[out] ppTrigger
Interface ITrigger qui représente le nouveau déclencheur.
Passez une référence à un pointeur d’interface NULLITrigger. Le référencement d’un pointeur NULL nonpeut provoquer une fuite de mémoire, car le pointeur sera remplacé.
Valeur de retour
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.
Exigences
| Exigence |
Valeur |
|
client minimum pris en charge |
Windows Vista [applications de bureau uniquement] |
|
serveur minimum pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
|
plateforme cible |
Windows |
|
d’en-tête |
taskschd.h |
|
bibliothèque |
Taskschd.lib |
|
DLL |
Taskschd.dll |
Voir aussi
ITriggerCollection
planificateur de tâches