Recuperando exemplos de propriedade de tarefa

Para recuperar as propriedades de uma tarefa, chame ITaskScheduler::Ativar para recuperar a interface do objeto de tarefa e, em seguida, chame o método ITask apropriado para recuperar a propriedade da tarefa na qual você está interessado. Os exemplos de código listados na parte inferior da página mostram como recuperar as diferentes propriedades da tarefa.

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 de não serem 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 na qual 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 a 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

 

Exemplos do Agendador de Tarefas 1.0