Compartilhar via


TASK_CREATION enumeração (taskschd.h)

Define como o serviço Agendador de Tarefas cria, atualiza ou desabilita a tarefa.

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
O serviço Agendador de Tarefas verifica a sintaxe do XML que descreve a tarefa, mas não registra a tarefa. Essa constante não pode ser combinada com os valores TASK_CREATE, TASK_UPDATE ou TASK_CREATE_OR_UPDATE .
TASK_CREATE
Valor: 0x2
O serviço Agendador de Tarefas registra a tarefa como uma nova tarefa.
TASK_UPDATE
Valor: 0x4
O serviço Agendador de Tarefas registra a tarefa como uma versão atualizada de uma tarefa existente. Quando uma tarefa com um gatilho de registro for atualizada, a tarefa será executada após a atualização ocorrer.
TASK_CREATE_OR_UPDATE
O serviço Agendador de Tarefas registrará a tarefa como uma nova tarefa ou como uma versão atualizada se a tarefa já existir. Equivalente a TASK_CREATE | TASK_UPDATE.
TASK_DISABLE
Valor: 0x8
O serviço Agendador de Tarefas registra a tarefa desabilitada. Uma tarefa desabilitada não pode ser executada até que esteja habilitada. Para obter mais informações, consulte Propriedade Enabled de ITaskSettings e Propriedade Enabled de IRegisteredTask.
TASK_DONT_ADD_PRINCIPAL_ACE
Valor: 0x10
O serviço Agendador de Tarefas é impedido de adicionar a ACE (entrada de controle de acesso) para a entidade de contexto. Quando as funções ITaskFolder::RegisterTaskDefinition ou ITaskFolder::RegisterTask são chamadas com esse sinalizador para atualizar uma tarefa, o serviço Agendador de Tarefas não adiciona o ACE para a nova entidade de contexto e não remove o ACE da entidade de contexto antiga.
TASK_IGNORE_REGISTRATION_TRIGGERS
Valor: 0x20
O serviço Agendador de Tarefas cria a tarefa, mas ignora os gatilhos de registro na tarefa. Ignorando os gatilhos de registro, a tarefa não será executada quando for registrada, a menos que um gatilho baseado em tempo faça com que ela seja executada no registro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho taskschd.h

Confira também

Tipos enumerados do agendador de tarefas