[[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 |
Confira também
IProvideTaskPage::GetPage
IScheduledWorkItem::SetAccountInformation
IScheduledWorkItem::SetComment
IScheduledWorkItem::SetFlags
IScheduledWorkItem::SetIdleWait
ITask::SetApplicationName
ITask::SetMaxRunTime
ITask::SetWorkingDirectory
TASK_TRIGGER