Partilhar via


Definindo exemplos de propriedade de item de trabalho

Para definir 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 definir 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 da página mostram como definir 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.

 

Nos exemplos a seguir, o objeto modificado é sempre salvo no disco por uma chamada para IPersistFile::Save. (A interface IPersistFile é uma interface COM padrão herdada pelo objeto de tarefa.)

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

Para definir 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 IScheduledWorkItem para definir a propriedade na qual está interessado. Observe que os métodos de IScheduledWorkItem são herdados pela interface ITask.
  4. Chame IPersistFile::Save para armazenar o objeto de tarefa modificado no disco.
Para obter um exemplo de código de Ver
Definir as informações da conta para uma tarefa conhecida Exemplo de código C/C++: Definindo informações de conta de tarefa
Definindo um comentário para uma tarefa já conhecida Exemplo de código C/C++: Configurando comentário de tarefa

 

Exemplos do Agendador de Tarefas 1.0