énumération TASK_CREATION (taskschd.h)

  • Article

Définit la façon dont le service Planificateur de tâches crée, met à jour ou désactive la tâche.

Syntax

typedef enum _TASK_CREATION {
  TASK_VALIDATE_ONLY = 0x1,
  TASK_CREATE = 0x2,
  TASK_UPDATE = 0x4,
  TASK_CREATE_OR_UPDATE,
  TASK_DISABLE = 0x8,
  TASK_DONT_ADD_PRINCIPAL_ACE = 0x10,
  TASK_IGNORE_REGISTRATION_TRIGGERS = 0x20
} TASK_CREATION;

Constantes

 
TASK_VALIDATE_ONLY
Valeur : 0x1
Le service Planificateur de tâches vérifie la syntaxe du code XML qui décrit la tâche, mais n’enregistre pas la tâche. Cette constante ne peut pas être combinée avec les valeurs TASK_CREATE, TASK_UPDATE ou TASK_CREATE_OR_UPDATE .
TASK_CREATE
Valeur : 0x2
Le service Planificateur de tâches inscrit la tâche en tant que nouvelle tâche.
TASK_UPDATE
Valeur : 0x4
Le service Planificateur de tâches inscrit la tâche en tant que version mise à jour d’une tâche existante. Lorsqu’une tâche avec un déclencheur d’inscription est mise à jour, la tâche s’exécute une fois la mise à jour effectuée.
TASK_CREATE_OR_UPDATE
Le service Planificateur de tâches inscrit la tâche en tant que nouvelle tâche ou en tant que version mise à jour si la tâche existe déjà. Équivalent à TASK_CREATE | TASK_UPDATE.
TASK_DISABLE
Valeur : 0x8
Le service Planificateur de tâches inscrit la tâche désactivée. Une tâche désactivée ne peut pas s’exécuter tant qu’elle n’est pas activée. Pour plus d’informations, consultez Enabled Property of ITaskSettings et Enabled Property of IRegisteredTask.
TASK_DONT_ADD_PRINCIPAL_ACE
Valeur : 0x10
Le service Planificateur de tâches ne peut pas ajouter l’entrée d’autorisation de contrôle d’accès (ACE) pour le principal de contexte. Lorsque les fonctions ITaskFolder ::RegisterTaskDefinition ou ITaskFolder ::RegisterTask sont appelées avec cet indicateur pour mettre à jour une tâche, le service Planificateur de tâches n’ajoute pas l’ace pour le nouveau principal de contexte et ne supprime pas l’ace de l’ancien principal de contexte.
TASK_IGNORE_REGISTRATION_TRIGGERS
Valeur : 0x20
Le service Planificateur de tâches crée la tâche, mais ignore les déclencheurs d’inscription dans la tâche. En ignorant les déclencheurs d’inscription, la tâche ne s’exécute pas lorsqu’elle est inscrite, sauf si un déclencheur basé sur le temps l’oblige à s’exécuter lors de l’inscription.

Configuration requise

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]
En-tête taskschd.h

Voir aussi

Types énumérés du planificateur de tâches