TASK_CREATION-Enumeration (taskschd.h)

  • Artikel

Definiert, wie der Taskplaner-Dienst den Task erstellt, aktualisiert oder deaktiviert.

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;

Konstanten

 
TASK_VALIDATE_ONLY
Wert: 0x1
Der Aufgabenplanungsdienst überprüft die Syntax des XML-Codes, der die Aufgabe beschreibt, aber den Vorgang nicht registriert. Diese Konstante kann nicht mit den werten TASK_CREATE, TASK_UPDATE oder TASK_CREATE_OR_UPDATE kombiniert werden.
TASK_CREATE
Wert: 0x2
Der Taskplaner-Dienst registriert den Vorgang als neuen Vorgang.
TASK_UPDATE
Wert: 0x4
Der Aufgabenplanungsdienst registriert den Vorgang als aktualisierte Version eines vorhandenen Vorgangs. Wenn eine Aufgabe mit einem Registrierungstrigger aktualisiert wird, wird der Task nach dem Update ausgeführt.
TASK_CREATE_OR_UPDATE
Der Aufgabenplanungsdienst registriert den Vorgang entweder als neue Aufgabe oder als aktualisierte Version, wenn der Vorgang bereits vorhanden ist. Entspricht TASK_CREATE | TASK_UPDATE.
TASK_DISABLE
Wert: 0x8
Der Taskplaner-Dienst registriert die deaktivierte Aufgabe. Ein deaktivierter Task kann erst ausgeführt werden, wenn er aktiviert ist. Weitere Informationen finden Sie unter Enabled-Eigenschaft von ITaskSettings und Enabled-Eigenschaft von IRegisteredTask.
TASK_DONT_ADD_PRINCIPAL_ACE
Wert: 0x10
Der Aufgabenplanungsdienst wird daran gehindert, den Zugriffssteuerungseintrag zulassen (ACE) für den Kontextprinzipal hinzuzufügen. Wenn die Funktionen ITaskFolder::RegisterTaskDefinition oder ITaskFolder::RegisterTask mit diesem Flag aufgerufen werden, um eine Aufgabe zu aktualisieren, fügt der Aufgabenplanungsdienst den ACE für den neuen Kontextprinzipal nicht hinzu und entfernt den ACE nicht aus dem alten Kontextprinzipal.
TASK_IGNORE_REGISTRATION_TRIGGERS
Wert: 0x20
Der Aufgabenplanungsdienst erstellt die Aufgabe, ignoriert jedoch die Registrierungstrigger in der Aufgabe. Durch Ignorieren der Registrierungstrigger wird der Task nicht ausgeführt, wenn er registriert wird, es sei denn, ein zeitbasierter Trigger bewirkt, dass er bei der Registrierung ausgeführt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile taskschd.h

Weitere Informationen

Aufgabenplanungs-Enumerierte Typen