Enumeração TASKPAGE (mstask.h)

Artigo
08/25/2023

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou produto. Em vez disso, use os Tipos Enumerados do Agendador de Tarefas 2.0 .] ]

Define o tipo de página de tarefa a ser recuperada.

Cada página de propriedades pode ser usada para definir as propriedades de um objeto de tarefa.

Syntax

typedef enum _TASKPAGE {
  TASKPAGE_TASK = 0,
  TASKPAGE_SCHEDULE = 1,
  TASKPAGE_SETTINGS = 2
} TASKPAGE;

Constantes


`TASKPAGE_TASK` Valor: 0 Especifica a página Tarefa da tarefa. Esta página fornece os seguintes elementos de interface do usuário: Executar: esse campo especifica o nome do aplicativo associado à tarefa. Essa propriedade também pode ser definida programaticamente chamando ITask::SetApplicationName. Iniciar em: este campo especifica o diretório de trabalho para a tarefa. Essa propriedade também pode ser definida programaticamente chamando ITask::SetWorkingDirectory. Comentários: esse campo especifica os comentários definidos pelo aplicativo para a tarefa. Essa propriedade também pode ser definida programaticamente chamando IScheduledWorkItem::SetComment. Execute como: (somente Windows Server 2003, Windows XP e Windows 2000.) Esse campo especifica o nome da conta na qual a tarefa será executada. À direita desse campo está um botão Senha para especificar a senha da conta. Essa propriedade também pode ser definida programaticamente chamando IScheduledWorkItem::SetAccountInformation. Habilitado (a tarefa agendada é executada em um momento específico): essa caixa de seleção especifica se o sinalizador de TASK_TRIGGER_FLAG_DISABLED está definido. Essa propriedade também pode ser definida definindo esse sinalizador no membro rgFlags do TASK_TRIGGER estrutura.
`TASKPAGE_SCHEDULE` Valor: 1 Especifica a página Agenda para a tarefa. Esta página é usada para gerenciar os gatilhos da tarefa. O usuário pode criar gatilhos, editar gatilhos e excluir gatilhos desta página. Esta página fornece os seguintes elementos de interface do usuário: Caixa de listagem de gatilho: essa caixa de listagem será exibida somente se houver vários gatilhos. Tarefa agendada: esse campo especifica a frequência com que a tarefa será executada: diária, semanal, mensal, uma vez, na inicialização do sistema, no logon ou quando estiver ociosa. Hora de Início: este campo especifica a hora do dia em que a tarefa será executada. Avançado: esse botão permite que você defina a data de início e a data de término para executar a tarefa. Caixa Agendar Grupo de tarefas: essa caixa de grupo só será exibida se o campo Agendar Tarefa especificar diariamente, semanalmente, mensalmente ou uma vez. Mostrar vários agendamentos: mostra todos os gatilhos. Quando marcada, a caixa de listagem Disparar é exibida.
`TASKPAGE_SETTINGS` Valor: 2 Especifica a página Configurações da tarefa. O usuário pode especificar o que acontece quando a tarefa é concluída, condições ociosas e propriedades de gerenciamento de energia para a tarefa. Esta página fornece os seguintes elementos de interface do usuário: Caixa de grupo Tarefa Concluída Agendada: essa caixa de grupo inclui caixas de marcar para definir o sinalizador TASK_FLAG_DELETE_WHEN_DONE e o tempo de execução máximo para a tarefa. O sinalizador TASK_FLAG_DELETE_WHEN_DONE também pode ser definido programaticamente chamando IScheduledWorkItem::SetFlags. O tempo de execução máximo pode ser definido chamando ITask::SetMaxRunTime. Caixa de grupo Tempo Ocioso: essa caixa de grupo inclui campos para definir condições ociosas. O tempo ocioso também pode ser definido programaticamente chamando IScheduledWorkItem::SetIdleWait. Os sinalizadores TASK_FLAG_START_ONLY_IF_IDLE e TASK_FLAG_KILL_ON_IDLE_END podem ser definidos chamando IScheduledWorkItem::SetFlags. Caixa do grupo de gerenciamento de energia: (somente Windows 95) Essa caixa de grupo inclui marcar caixas para indicar como a tarefa se comporta quando o sistema está perdendo energia. Essas propriedades também podem ser definidas programaticamente definindo os sinalizadores TASK_FLAG_DONT_START_IF_ON_BATTERIES e TASK_FLAG_KILL_IF_GOING_ON_BATTERIES usando IScheduledWorkItem::SetFlags.

Requisitos

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