Partilhar via

Obtenção de Exemplos de Propriedades de Itens 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 de 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 para tarefas, consulte Definindo exemplos de propriedades de tarefas.

Observação

No exemplo de código a seguir, todas as interfaces são liberadas depois que não são mais necessárias.

 

Observe que, se você estiver recuperando uma propriedade string (como comment para um item de trabalho), deverá chamar CoTaskMemFree para liberar a memória alocada para a string retornada.

O procedimento a seguir descreve como recuperar uma propriedade de uma tarefa.

Para recuperar uma propriedade de tarefa

  1. Chame CoInitialize para inicializar a biblioteca COM e CoCreateInstance para obter um objeto Agendador de Tarefas. (Estes 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 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 está interessado.
  4. Processe a propriedade conforme necessário. (Esses exemplos apenas imprimem a propriedade no ecrã.)
  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 Ver
Recuperando as informações da conta de uma tarefa já conhecida Exemplo de código C/C++: Recuperando informações de 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
Recuperar o nome do criador da tarefa e exibi-lo 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 código de saída de tarefa
Recuperando o tempo de espera ocioso da tarefa e exibindo-o na tela Exemplo de código C/C++: Recuperando o tempo de espera ociosa da tarefa
Recuperar a hora em que a tarefa foi executada pela última vez e exibi-la na tela Exemplo de código C/C++: Recuperando a tarefa MostRecentRun Time
Recuperar a próxima vez que a tarefa estiver agendada para ser executada e exibir essa hora na tela Exemplo de código C/C++: Recuperando a tarefa NextRun Time
Recuperando os tempos de execução da tarefa e exibindo-os na tela Exemplo de código C/C++: Recuperando tempos de execução de tarefas
Recuperando o status atual da tarefa e exibindo-o na tela Exemplo de código C/C++: Recuperando o status da tarefa

 

Exemplos do Agendador de Tarefas 1.0

 

 

  • Last updated on