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

Artículo
02/29/2024

[[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