Recuperando exemplos de propriedade de item de trabalho

Para recuperar as propriedades de um item de trabalho, chame ITaskScheduler::Activate para recuperar a interface do objeto de item de trabalho e, em seguida, chame o método apropriado para recuperar a propriedade da tarefa em que você está interessado. Atualmente, os únicos itens de trabalho válidos são tarefas.

Os exemplos de código listados na parte inferior desta página mostram como recuperar as propriedades que se aplicam a todos os itens de trabalho. Para outras propriedades exclusivas das tarefas, consulte Definindo exemplos de propriedade de tarefa.

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 comentário para um item 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 CoCreateInstance para obter um objeto Agendador de Tarefas. (Esses exemplos pressupõem que o serviço agendador de tarefas está em execução.)
2. Chame ITaskScheduler::Activate para obter a interface ITask do objeto de tarefa. (Observe que as tarefas são atualmente o único tipo válido de item de trabalho.)
3. Chame o método apropriado para recuperar a propriedade em que você está interessado.
4. Processe a propriedade conforme necessário. (Esses exemplos simplesmente 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 as informações da conta de uma tarefa conhecida	Exemplo de código C/C++: recuperando informações da conta de tarefa
Recuperando a cadeia de caracteres de comentário de uma tarefa conhecida	Exemplo de código C/C++: recuperando um comentário de tarefa
Recuperando o nome do criador da tarefa e exibindo-o na tela	Exemplo de código C/C++: recuperando o criador de tarefas
Recuperando o último código de saída retornado por uma tarefa conhecida	Exemplo de código C/C++: recuperando o código de saída da tarefa
Recuperando o tempo de espera ociosa da tarefa e exibindo-o na tela	Exemplo de código C/C++: recuperando o tempo de espera ocioso da tarefa
Recuperando a hora em que a tarefa foi executada pela última vez e exibindo-a na tela	Exemplo de código C/C++: recuperando a tarefa MostRecentRun Time
Recuperando a próxima vez que a tarefa for agendada para ser executada e exibindo essa hora na tela	Exemplo de código C/C++: recuperando a próxima execução da tarefa
Recuperando os tempos de execução da tarefa e exibindo-os na tela	Exemplo de código C/C++: recuperando tempos de execução da tarefa
Recuperando a status atual da tarefa e exibindo-a na tela	Exemplo de código C/C++: recuperando o status da tarefa

 

Tópicos relacionados

Exemplos do Agendador de Tarefas 1.0