Método IScheduledWorkItem::D eleteTrigger (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. ]
Elimina un desencadenador de un elemento de trabajo.
Sintaxis
HRESULT DeleteTrigger(
[in] WORD iTrigger
);
Parámetros
[in] iTrigger
Valor de índice del desencadenador que especifica el desencadenador que se va a eliminar. Para obtener más información, vea la sección Comentarios.
Valor devuelto
El método DeleteTrigger 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
Se crea un índice de desencadenador para cada desencadenador cuando se crea el desencadenador. Sin embargo, no es un identificador único para un desencadenador específico. Por ejemplo, si crea cuatro desencadenadores, se numerarán de 0 a 3. Pero si se elimina el segundo desencadenador, los desencadenadores restantes se numerarán de 0 a 2. Tenga en cuenta que el índice del primer desencadenador siempre es 0 y el índice del último desencadenador es uno menor que el número total de desencadenadores para el elemento de trabajo (TriggerCount -1).
Puede recuperar el recuento de desencadenadores mediante IScheduledWorkItem::GetTriggerCount.
Para completar la eliminación del desencadenador, los programas deben llamar al método IPersistFile::Save después de llamar a DeleteTrigger. Al llamar a IPersistFile::Save, se guardan los cambios en el disco.
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 |