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

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

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

Quando você estiver trabalhando com um objeto de gatilho de tarefa, use os métodos da interface ITaskTrigger para recuperar a cadeia de caracteres de gatilho do gatilho.

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 caracteres 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 o 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 interface ITask do objeto de tarefa. (Observe que este exemplo obtém a tarefa "Tarefa de Teste".)
3. Chame ITask::GetTriggerCount para descobrir quantos gatilhos 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étodo IScheduledWorkItem herdado por ITask.)
5. Libere todos os recursos. Chame CoTaskMemFree para liberar as cadeias de caracteres de gatilho e ITask::Release para liberar a interface ITask . (Observe que Release é um método IUnknown herdado por ITask.)

Tópicos relacionados

Exemplos do Agendador de Tarefas 1.0