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