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

Artigo
07/16/2024

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

Compartilhar via