ITriggerCollection ::Create, méthode (taskschd.h)

  • Article

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 à un moment spécifique de la journée.
TASK_TRIGGER_DAILY
2
 Déclenche la tâche selon une planification quotidienne. Par exemple, la tâche démarre à une heure spécifique tous les jours, tous les autres jours, tous les trois jours, etc.
TASK_TRIGGER_WEEKLY
3
 Déclenche la tâche selon une planification hebdomadaire. Par exemple, la tâche commence à 8h00 sur un 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 à des jours spécifiques de mois spécifiques.
TASK_TRIGGER_MONTHLYDOW
5
 Déclenche la tâche selon une planification mensuelle d’un jour de la semaine. Par exemple, la tâche démarre sur des jours spécifiques 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 à l’é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 au démarrage de l’ordinateur.
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.

Transmettez une référence à un pointeur d’interface ITriggerNULL. Le référencement d’un pointeur non NULL peut entraîner une fuite de mémoire, car le pointeur sera remplacé.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête taskschd.h
Bibliothèque Taskschd.lib
DLL Taskschd.dll

Voir aussi

ITriggerCollection

Planificateur de tâches