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 |