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