Exemplo de recuperação de cadeias de caracteres de gatilho

Você pode recuperar as cadeias de caracteres de um gatilho conhecido usando a interface IScheduledWorkItem ou a interface ITaskTrigger, dependendo do tipo de objeto com o qual você está a trabalhar.

Ao trabalhar com um objeto de tarefa , use os métodos do IScheduledWorkItem interface para recuperar as cadeias de caracteres de gatilho de um item de trabalho.

Quando estiver a trabalhar com um objeto de ativação de tarefa , use os métodos da interface ITaskTrigger do para recuperar a cadeia de caracteres do ativador.

O exemplo a seguir mostra como usar IScheduledWorkItem::GetTriggerString para exibir as cadeias de caracteres de todos os gatilhos associados a uma tarefa conhecida.

O procedimento a seguir descreve como recuperar as cadeias de gatilho de uma tarefa.

Para recuperar as cadeias de caracteres de gatilho de uma tarefa

1. Chame CoInitialize para inicializar a biblioteca COM e CoCreateInstance para obter um objeto Agendador de Tarefas. (Este exemplo pressupõe que o serviço Agendador de Tarefas esteja em execução.)
2. Chame ITaskScheduler::Activate para obter a ITask interface do objeto de tarefa. Observe que este exemplo recebe a tarefa "Tarefa de Teste".
3. Chame ITask::GetTriggerCount para descobrir quantos disparadores estão associados a uma tarefa. (Observe que GetTriggerCount é um método IScheduledWorkItem herdado por ITask.)
4. Exiba as cadeias de caracteres de gatilho, chamando ITask::GetTriggerString para cada gatilho associado à tarefa. (Observe que GetTriggerString é um métodoIScheduledWorkItemherdado por ITask.)
5. Libere todos os recursos. Chame CoTaskMemFree para liberar as cadeias de caracteres de gatilho e ITask::Release para liberar a ITask interface. (Observe que Release é um métodoIUnknownherdado por ITask.)

Tópicos relacionados

Exemplos do Agendador de Tarefas 1.0