Interface ITask (mstask.h)

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

Fornece os métodos para executar tarefas, obter ou definir informações de tarefa e encerrar tarefas. Ele é derivado da interface IScheduledWorkItem e herda todos os métodos dessa interface.

Herança

A interface ITask herda de IScheduledWorkItem. O ITask também tem esses tipos de membros:

Métodos

A interface ITask tem esses métodos.

ITask::GetApplicationName Esse método recupera o nome do aplicativo ao qual a tarefa está associada.
ITask::GetMaxRunTime Esse método recupera o período máximo de tempo, em milissegundos, a tarefa pode ser executada antes de terminar.
ITask::GetParameters Esse método recupera os parâmetros de linha de comando da tarefa.
ITask::GetPriority Esse método recupera a prioridade da tarefa.
ITask::GetTaskFlags Esse método retorna os sinalizadores que modificam o comportamento de uma tarefa.
ITask::GetWorkingDirectory Esse método recupera o diretório de trabalho da tarefa.
ITask::SetApplicationName Esse método atribui um aplicativo específico à tarefa atual.
ITask::SetMaxRunTime Esse método define o tempo máximo que a tarefa pode executar, em milissegundos, antes de terminar.
ITask::SetParameters Esse método define os parâmetros de linha de comando para a tarefa.
ITask::SetPriority Esse método define a prioridade para a tarefa.
ITask::SetTaskFlags Esse método define os sinalizadores que modificam o comportamento de uma tarefa agendada.
ITask::SetWorkingDirectory Esse método define o diretório de trabalho para a tarefa.

Comentários

ITask é a interface primária do objeto de gatilho de tarefa. Para criar um objeto de tarefa, chame ITaskScheduler::Activate para tarefas existentes ou ITaskScheduler::NewWorkItem para novas tarefas.

Exemplos

Para obter mais informações e código de exemplo para essa interface, consulte Exemplo de código C/C++: Encerrando uma tarefa.

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]
Plataforma de Destino	Windows
Cabeçalho	mstask.h
Redistribuível	Internet Explorer 4.0 ou posterior no Windows NT 4.0 e Windows 95

Confira também

IScheduledWorkItem

ITaskScheduler::Activate

ITaskScheduler::NewWorkItem