Método ITriggerCollection::Create (taskschd.h)

  • Artigo

Cria um novo gatilho para a tarefa.

Sintaxe

HRESULT Create(
  [in]  TASK_TRIGGER_TYPE2 type,
  [out] ITrigger           **ppTrigger
);

Parâmetros

[in] type

Esse parâmetro é definido como uma das seguintes constantes de enumeração TASK_TRIGGER_TYPE2 .

Valor Significado
TASK_TRIGGER_EVENT
0
 Dispara a tarefa quando ocorre um evento específico.
TASK_TRIGGER_TIME
1
 Dispara a tarefa em uma hora específica do dia.
TASK_TRIGGER_DAILY
2
 Dispara a tarefa em um agendamento diário. Por exemplo, a tarefa começa em um horário específico todos os dias, todos os dias, a cada três dias e assim por diante.
TASK_TRIGGER_WEEKLY
3
 Dispara a tarefa em um agendamento semanal. Por exemplo, a tarefa começa às 8h em um dia específico a cada semana ou outra semana.
TASK_TRIGGER_MONTHLY
4
 Dispara a tarefa em um agendamento mensal. Por exemplo, a tarefa começa em dias específicos de meses específicos.
TASK_TRIGGER_MONTHLYDOW
5
 Dispara a tarefa em um agendamento mensal do dia da semana. Por exemplo, a tarefa começa em dias específicos da semana, semanas do mês e meses do ano.
TASK_TRIGGER_IDLE
6
 Dispara a tarefa quando o computador entra em um estado ocioso.
TASK_TRIGGER_REGISTRATION
7
 Dispara a tarefa quando a tarefa é registrada.
TASK_TRIGGER_BOOT
8
 Dispara a tarefa quando o computador é inicializado.
TASK_TRIGGER_LOGON
9
 Dispara a tarefa quando um usuário específico faz logon.
TASK_TRIGGER_SESSION_STATE_CHANGE
11
 Dispara a tarefa quando um estado de sessão específico é alterado.

[out] ppTrigger

Uma interface ITrigger que representa o novo gatilho.

Passe uma referência para um ponteiro de interface ITriggerNULL. Fazer referência a um ponteiro não NULL pode causar um vazamento de memória porque o ponteiro será substituído.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho taskschd.h
Biblioteca Taskschd.lib
DLL Taskschd.dll

Confira também

ITriggerCollection

Agendador de Tarefas