Compartir a través de

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

  • Artículo

Crea un nuevo desencadenador para la tarea.

Sintaxis

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

Parámetros

[in] type

Este parámetro se establece en una de las siguientes constantes de enumeración TASK_TRIGGER_TYPE2.

Valor Significado
TASK_TRIGGER_EVENT
0
 Desencadena la tarea cuando se produce un evento específico.
TASK_TRIGGER_TIME
1
 Desencadena la tarea en una hora específica del día.
TASK_TRIGGER_DAILY
2
 Desencadena la tarea según una programación diaria. Por ejemplo, la tarea se inicia en una hora específica cada día, cada otro día, cada tercer día, etc.
TASK_TRIGGER_WEEKLY
3
 Desencadena la tarea según una programación semanal. Por ejemplo, la tarea comienza a las 8:00 a.m. en un día específico cada semana u otra semana.
TASK_TRIGGER_MONTHLY
4
 Desencadena la tarea según una programación mensual. Por ejemplo, la tarea se inicia en días específicos de meses específicos.
TASK_TRIGGER_MONTHLYDOW
5
 Desencadena la tarea en una programación mensual del día de la semana. Por ejemplo, la tarea se inicia en días específicos de la semana, semanas del mes y meses del año.
TASK_TRIGGER_IDLE
6
 Desencadena la tarea cuando el equipo entra en un estado inactivo.
TASK_TRIGGER_REGISTRATION
7
 Desencadena la tarea cuando se registra la tarea.
TASK_TRIGGER_BOOT
8
 Desencadena la tarea cuando se inicia el equipo.
TASK_TRIGGER_LOGON
9
 Desencadena la tarea cuando un usuario específico inicia sesión.
TASK_TRIGGER_SESSION_STATE_CHANGE
11
 Desencadena la tarea cuando cambia un estado de sesión específico.

[out] ppTrigger

Interfaz ITrigger que representa el nuevo desencadenador.

Pase una referencia a un puntero de interfazITrigger NULL. Hacer referencia a un puntero null nopuede provocar una pérdida de memoria porque se sobrescribirá el puntero.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de taskschd.h
biblioteca de Taskschd.lib
DLL de Taskschd.dll

Consulte también

ITriggerCollection

programador de tareas de