TASK_CREATION enumeración (taskschd.h)

Define cómo crea, actualiza o deshabilita la tarea el servicio Programador de tareas.

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
Valor: 0x1
El servicio Programador de tareas comprueba la sintaxis del XML que describe la tarea, pero no registra la tarea. Esta constante no se puede combinar con los valores de TASK_CREATE, TASK_UPDATE o TASK_CREATE_OR_UPDATE .
TASK_CREATE
Valor: 0x2
El servicio Programador de tareas registra la tarea como una nueva tarea.
TASK_UPDATE
Valor: 0x4
El servicio Programador de tareas registra la tarea como una versión actualizada de una tarea existente. Cuando se actualiza una tarea con un desencadenador de registro, la tarea se ejecutará después de que se produzca la actualización.
TASK_CREATE_OR_UPDATE
El servicio Programador de tareas registra la tarea como una nueva tarea o como una versión actualizada si la tarea ya existe. Equivalente a TASK_CREATE | TASK_UPDATE.
TASK_DISABLE
Valor: 0x8
El servicio Programador de tareas registra la tarea deshabilitada. Una tarea deshabilitada no se puede ejecutar hasta que esté habilitada. Para obtener más información, vea Enabled (propiedad) de ITaskSettings y enabled (propiedad) de IRegisteredTask.
TASK_DONT_ADD_PRINCIPAL_ACE
Valor: 0x10
El servicio Programador de tareas no puede agregar la entrada permitir el control de acceso (ACE) para la entidad de seguridad de contexto. Cuando se llama a las funciones ITaskFolder::RegisterTaskDefinition o ITaskFolder::RegisterTask con esta marca para actualizar una tarea, el servicio Programador de tareas no agrega la ACE para la nueva entidad de contexto y no quita la ACE de la entidad de contexto anterior.
TASK_IGNORE_REGISTRATION_TRIGGERS
Valor: 0x20
El servicio Programador de tareas crea la tarea, pero omite los desencadenadores de registro en la tarea. Al omitir los desencadenadores de registro, la tarea no se ejecutará cuando se registre, a menos que un desencadenador basado en tiempo haga que se ejecute en el registro.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado taskschd.h

Consulte también

Tipos enumerados del programador de tareas