Compartilhar via


Interface IScheduledWorkItem (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 gerenciar itens de trabalho específicos.

Herança

A interface IScheduledWorkItem herda da interface IUnknown . IScheduledWorkItem também tem estes tipos de membros:

Métodos

A interface IScheduledWorkItem tem esses métodos.

 
IScheduledWorkItem::CreateTrigger

Cria um gatilho para o item de trabalho.
IScheduledWorkItem::D eleteTrigger

Exclui um gatilho de um item de trabalho.
IScheduledWorkItem::EditWorkItem

Exibe as páginas de propriedades Tarefa, Agendamento e configurações do item de trabalho, permitindo que um usuário defina as propriedades nessas páginas.
IScheduledWorkItem::GetAccountInformation

Recupera o nome da conta do item de trabalho.
IScheduledWorkItem::GetComment

Recupera o comentário do item de trabalho.
IScheduledWorkItem::GetCreator

Recupera o nome do criador do item de trabalho.
IScheduledWorkItem::GetErrorRetryCount

Recupera o número de vezes que o Agendador de Tarefas tentará novamente uma operação quando ocorrer um erro. Este método não está implementado.
IScheduledWorkItem::GetErrorRetryInterval

Recupera o intervalo de tempo, em minutos, entre as tentativas do Agendador de Tarefas de executar um item de trabalho se ocorrer um erro. Este método não está implementado.
IScheduledWorkItem::GetExitCode

Recupera o último código de saída retornado pelo executável associado ao item de trabalho em sua última execução. O método também retorna o código de saída retornado ao Agendador de Tarefas quando tentou executar o item de trabalho pela última vez.
IScheduledWorkItem::GetFlags

Recupera os sinalizadores que modificam o comportamento de qualquer tipo de item de trabalho.
IScheduledWorkItem::GetIdleWait

Recupera o tempo de espera ocioso para o item de trabalho.
IScheduledWorkItem::GetMostRecentRunTime

Recupera a hora mais recente em que o item de trabalho começou a ser executado.
IScheduledWorkItem::GetNextRunTime

Recupera a próxima vez que o item de trabalho for executado.
IScheduledWorkItem::GetRunTimes

Recupera os tempos de execução do item de trabalho para um período de tempo especificado.
IScheduledWorkItem::GetStatus

Recupera o status do item de trabalho.
IScheduledWorkItem::GetTrigger

Recupera um gatilho de tarefa.
IScheduledWorkItem::GetTriggerCount

Recupera o número de gatilhos para o item de trabalho atual.
IScheduledWorkItem::GetTriggerString

Recupera uma cadeia de caracteres que descreve o gatilho do item de trabalho.
IScheduledWorkItem::GetWorkItemData

Recupera dados definidos pelo aplicativo associados ao item de trabalho.
IScheduledWorkItem::Run

Envia uma solicitação para o serviço Agendador de Tarefas para executar o item de trabalho.
IScheduledWorkItem::SetAccountInformation

Define o nome da conta e a senha usados para executar o item de trabalho.
IScheduledWorkItem::SetComment

Define o comentário para o item de trabalho.
IScheduledWorkItem::SetCreator

Define o nome do criador do item de trabalho.
IScheduledWorkItem::SetErrorRetryCount

Define o número de vezes que o Agendador de Tarefas tentará executar o item de trabalho novamente se ocorrer um erro. Este método não está implementado.
IScheduledWorkItem::SetErrorRetryInterval

Define o intervalo de tempo, em minutos, entre as tentativas do Agendador de Tarefas de executar um item de trabalho após ocorrer um erro. Este método não está implementado.
IScheduledWorkItem::SetFlags

Define os sinalizadores que modificam o comportamento de qualquer tipo de item de trabalho.
IScheduledWorkItem::SetIdleWait

Define os minutos que o sistema deve ficar ocioso antes que o item de trabalho possa ser executado.
IScheduledWorkItem::SetWorkItemData

Esse método armazena dados definidos pelo aplicativo associados ao item de trabalho.
IScheduledWorkItem::Terminate

Esse método encerra a execução do item de trabalho.

Comentários

A interface IScheduledWorkItem é a interface base para a interface ITask . Todos os métodos fornecidos por IScheduledWorkItem são herdados pela interface ITask e normalmente são chamados por meio dessa interface.

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

Itask