Partilhar via

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

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 uma agenda diária. Por exemplo, a tarefa começa em um horário específico todos os dias, todos os dias, a cada terceiro dia 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 a um ponteiro de interfaceNULL ITrigger. Fazer referência a um ponteiro NULL nãopode causar um vazamento de memória porque o ponteiro será substituído.

Valor de retorno

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho taskschd.h
biblioteca Taskschd.lib
de DLL Taskschd.dll

Consulte também

ITriggerCollection

do Agendador de Tarefas

  • Last updated on