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 |
|---|---|
|
La operación se realizó correctamente. |
|
Los argumentos no son válidos. |
|
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
IScheduledWorkItem::D eleteTrigger
IScheduledWorkItem::GetTrigger