Compartir a través de


Método IScheduledWorkItem::CreateTrigger (mstask.h)

[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o del producto. Use las interfaces del Programador de tareas 2.0 en su lugar. ]

Crea un desencadenador para el elemento de trabajo.

Sintaxis

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

Parámetros

[out] piNewTrigger

Puntero al valor de índice del desencadenador devuelto del nuevo desencadenador. El índice de desencadenador del primer desencadenador asociado a un elemento de trabajo es "0". Consulte Comentarios para ver otros usos del índice de desencadenador.

[out] ppTrigger

Puntero a un puntero a una interfaz ITaskTrigger . Actualmente, los únicos elementos de trabajo admitidos son tareas.

Valor devuelto

El método CreateTrigger devuelve uno de los siguientes valores.

Código devuelto Descripción
S_OK
La operación se realizó correctamente.
E_INVALIDARG
Los argumentos no son válidos.
E_OUTOFMEMORY
No hay suficiente memoria disponible.

Comentarios

El índice de desencadenador devuelto por piNewTrigger se usa al recuperar o eliminar desencadenadores. Sin embargo, el índice del desencadenador no es un identificador. Indica solo la posición del nuevo desencadenador en relación con los otros desencadenadores actuales asociados al elemento de trabajo.

Para establecer los criterios del nuevo desencadenador, llame a ITaskTrigger::SetTrigger.

Después de crear un nuevo desencadenador para un elemento de trabajo, las aplicaciones deben llamar al método IPersistFile::Save para guardar el nuevo desencadenador en el disco.

Ejemplos

Para obtener un ejemplo de cómo establecer los criterios de desencadenador al crear un nuevo desencadenador, consulte Creación de un nuevo desencadenador.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mstask.h
Library Mstask.lib
Archivo DLL Mstask.dll
Redistribuible Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95

Consulte también

IPersistFile::Save

IScheduledWorkItem

IScheduledWorkItem::D eleteTrigger

IScheduledWorkItem::GetTrigger

IScheduledWorkItem::GetTriggerString

ITaskTrigger

ITaskTrigger::SetTrigger