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
- 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.)
- 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.)
- Chame o método apropriado para recuperar a propriedade em que você está interessado.
- Processe a propriedade conforme necessário. (Esses exemplos simplesmente 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 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