Compartir a través de


Método ITaskTrigger::SetTrigger (mstask.h)

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

El método SetTrigger establece los criterios de desencadenador para un desencadenador de tareas.

Sintaxis

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

Parámetros

[in] pTrigger

Puntero a una estructura TASK_TRIGGER que contiene los valores que definen el nuevo desencadenador de tarea.

Valor devuelto

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

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

Los miembros wBeginDay, wBeginMonth y wBeginYear de la estructura TASK_TRIGGER deben establecerse en un día, mes y año válidos, respectivamente.

Una tarea puede tener cualquier número de desencadenadores asociados. Las horas en que se ejecutará la tarea son la unión de todos los desencadenadores definidos para esa tarea.

Para actualizar la tarea con esta nueva configuración de desencadenador, las aplicaciones deben llamar al método IPersistFile::Save después de llamar a SetTrigger.

Ejemplos

En el código siguiente se muestra la declaración de variable y la sintaxis de llamada para este método, incluidos los miembros necesarios de TASK_TRIGGER. Al establecer los criterios de desencadenador al crear un nuevo desencadenador, consulte Creación de un nuevo desencadenador.

HRESULT hr = S_OK;

TASK_TRIGGER Trigger;

ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));

Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;

// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
   printf("Failed SetTrigger\n");
   exit(1);
}

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

ITaskTrigger

ITaskTrigger::GetTrigger

TASK_TRIGGER