Método ITask::SetMaxRunTime (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. ]
Este método establece el tiempo máximo que puede ejecutar la tarea , en milisegundos, antes de finalizar.
Sintaxis
HRESULT SetMaxRunTime(
[in] DWORD dwMaxRunTimeMS
);
Parámetros
[in] dwMaxRunTimeMS
Valor DWORD que especifica el tiempo de ejecución máximo (en milisegundos), para la tarea. Este parámetro se puede establecer en INFINITE para especificar un tiempo ilimitado.
Valor devuelto
El método SetMaxRunTime 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
Cuando se supera el tiempo de ejecución máximo, el Programador de tareas intenta finalizar la aplicación asociada a la tarea. Si no se puede enviar un mensaje de WM_CLOSE (por ejemplo, la aplicación no tiene ventanas) o la aplicación no ha salido en un plazo de tres minutos a partir de la WM_CLOSE receptora, el Programador de tareas finaliza la aplicación mediante TerminateProcess.
Después de establecer el tiempo de ejecución máximo, asegúrese de llamar a IPersistFile::Save para guardar el objeto de tarea modificado en el disco.
Ejemplos
Para obtener un ejemplo de cómo establecer el tiempo de ejecución máximo, vea Ejemplo de código de C/C++: Establecer MaxRunTime.
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 |