Método IScheduledWorkItem::CreateTrigger (mstask.h)

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

Cria um gatilho para o item de trabalho.

Sintaxe

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

Parâmetros

[out] piNewTrigger

Um ponteiro para o valor de índice de gatilho retornado do novo gatilho. O índice de gatilho para o primeiro gatilho associado a um item de trabalho é "0". Consulte Comentários para outros usos do índice de gatilho.

[out] ppTrigger

Um ponteiro para um ponteiro para uma interface ITaskTrigger . Atualmente, os únicos itens de trabalho com suporte são tarefas.

Retornar valor

O método CreateTrigger retorna um dos valores a seguir.

Comentários

Use o índice de gatilho retornado por piNewTrigger quando estiver recuperando ou excluindo gatilhos. No entanto, o índice de gatilho não é um identificador. Indica apenas a posição do novo gatilho em relação aos outros gatilhos atuais associados ao item de trabalho.

Para definir os critérios para o novo gatilho, chame ITaskTrigger::SetTrigger.

Depois de criar um novo gatilho para um item de trabalho, os aplicativos devem chamar o método IPersistFile::Save para salvar o novo gatilho em disco.

Exemplos

Para obter um exemplo de como definir os critérios de gatilho ao criar um novo gatilho, consulte Criando um novo gatilho.

Requisitos

Confira também

IPersistFile::Save

IScheduledWorkItem

IScheduledWorkItem::D eleteTrigger

IScheduledWorkItem::GetTrigger

IScheduledWorkItem::GetTriggerString

ITaskTrigger

ITaskTrigger::SetTrigger