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