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 todos los días, 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 interfaz ITriggerNULL. Hacer referencia a un puntero que no sea NULL puede provocar una pérdida de memoria porque el puntero se sobrescribirá.

Valor devuelto

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado taskschd.h
Library Taskschd.lib
Archivo DLL Taskschd.dll

Consulte también

ITriggerCollection

Programador de tareas