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

Article
07/16/2024

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

Partager via