Recuperando exemplos de propriedade de tarefa
Para recuperar as propriedades de uma tarefa, chame ITaskScheduler::Activate para recuperar a interface do objeto de tarefa e chame o método ITask apropriado para recuperar a propriedade de tarefa na qual você está interessado. Os exemplos de código listados na parte inferior da página mostram como recuperar as propriedades de tarefa diferentes.
Os exemplos de código listados na parte inferior da página mostram como recuperar as propriedades exclusivas dos objetos de tarefa. Para outras propriedades de item de trabalho que também se aplicam a tarefas, consulte Recuperando exemplos de item de trabalho.
Observação
No exemplo de código a seguir, todas as interfaces são liberadas depois que elas não são mais necessárias.
Observe que, se você estiver recuperando uma propriedade de cadeia de caracteres (como o nome do aplicativo, parâmetros ou diretório de trabalho), deverá chamar CoTaskMemFree para liberar a memória alocada para a cadeia de caracteres retornada.
O procedimento a seguir descreve como recuperar uma propriedade de tarefa.
Para recuperar uma propriedade de tarefa
- Chame CoInitialize para inicializar a biblioteca COM e o CoCreateInstance para obter um objeto Agendador de Tarefas. (Esses exemplos pressupõem que o serviço Agendador de Tarefas esteja em execução.)
- Chame ITaskScheduler::Activate para obter a interface ITask do objeto de tarefa. (Observe que este exemplo obtém a tarefa "Tarefa de Teste".)
- Chame o método ITask apropriado para recuperar a propriedade em que você está interessado.
- Processe a propriedade conforme necessário. (Esses exemplos imprimem a propriedade na tela.)
- Se a propriedade retornada for uma cadeia de caracteres, chame CoTaskMemFree para liberar a memória alocada para a cadeia de caracteres retornada.
| Para obter um exemplo de código de | Consulte |
|---|---|
| Recuperando o nome do aplicativo associado a uma determinada tarefa | Exemplo de código C/C++: recuperando o nome do aplicativo de tarefa |
| Recuperando a quantidade máxima de tempo que a tarefa pode executar e exibindo esse número na tela | Exemplo de código C/C++: recuperando a tarefa MaxRunTime |
| Recuperando a cadeia de caracteres de parâmetro executada quando a tarefa é executada e exibindo essa cadeia de caracteres na tela | Exemplo de código C/C++: recuperando parâmetros de tarefa |
| Recuperando o nível de prioridade da tarefa | Exemplo de código C/C++: recuperando prioridade da tarefa |
| Recuperando o diretório de trabalho de uma tarefa e exibindo o caminho para o diretório de trabalho na tela | Exemplo de código C/C++: recuperando o diretório de trabalho da tarefa |
Tópicos relacionados