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 |