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

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