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

1. 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.)
2. Chame ITaskScheduler::Activate para obter a interface ITask do objeto de tarefa. (Observe que este exemplo obtém a tarefa "Tarefa de Teste".)
3. Chame o método ITask apropriado para recuperar a propriedade em que você está interessado.
4. Processe a propriedade conforme necessário. (Esses exemplos imprimem a propriedade na tela.)
5. 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

Exemplos do Agendador de Tarefas 1.0