Método IScheduledWorkItem::SetFlags (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 . ]
Establece las marcas que modifican el comportamiento de cualquier tipo de elemento de trabajo.
Sintaxis
HRESULT SetFlags(
DWORD dwFlags
);
Parámetros
dwFlags
Valor que especifica una combinación de una o varias de las marcas siguientes:
TASK_FLAG_INTERACTIVE
Esta marca se usa al convertir los trabajos del servicio Windows NT AT en elementos de trabajo. El trabajo del servicio Windows NT AT hace referencia a At.exe, la utilidad de línea de comandos de Windows NT que se usa para crear trabajos para el servicio programación de Windows NT. El servicio Programador de tareas reemplaza el servicio Schedule y es compatible con ella con versiones anteriores. La conversión se produce cuando el Programador de tareas está instalado en Windows NT/Windows 2000, por ejemplo, si instala Internet Explorer 4.0 o actualiza a Windows 2000. Durante el proceso de instalación, el código de instalación del Programador de tareas busca los trabajos creados para el servicio AT y crea elementos de trabajo que realizarán la misma operación.
Para estos trabajos convertidos, la marca interactiva se establece si el elemento de trabajo está diseñado para mostrarse al usuario. Cuando no se establece esta marca, no se muestran elementos de trabajo en la carpeta Tareas y no se presenta ninguna interfaz de usuario asociada al elemento de trabajo al usuario cuando se ejecuta el elemento de trabajo.
TASK_FLAG_DELETE_WHEN_DONE
El elemento de trabajo se eliminará cuando no haya más tiempos de ejecución programados.
TASK_FLAG_DISABLED
El elemento de trabajo está deshabilitado. Esto resulta útil para evitar temporalmente que un elemento de trabajo se ejecute en las horas programadas.
TASK_FLAG_HIDDEN
El elemento de trabajo creado se ocultará.
TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
El elemento de trabajo solo se ejecuta si el usuario especificado en IScheduledWorkItem::SetAccountInformation se inicia sesión de forma interactiva. Esta marca no tiene ningún efecto en los elementos de trabajo que se establecen para ejecutarse en la cuenta local.
TASK_FLAG_START_ONLY_IF_IDLE
El elemento de trabajo solo comienza si el equipo no está en uso en la hora de inicio programada.
TASK_FLAG_SYSTEM_REQUIRED
El elemento de trabajo hace que el sistema se reanude o se despierte, si el sistema se está ejecutando con batería. Esta marca solo se admite en sistemas que admiten temporizadores de reanudación.
TASK_FLAG_KILL_ON_IDLE_END
El elemento de trabajo finaliza si el equipo realiza una transición inactiva a no inactiva mientras se ejecuta el elemento de trabajo. El equipo no se considera inactivo hasta que el tiempo de los desencadenadores IdleWait transcurre sin ninguna entrada del usuario. Para obtener información sobre los desencadenadores inactivos, consulte Desencadenador inactivo.
TASK_FLAG_RESTART_ON_IDLE_RESUME
El elemento de trabajo se inicia de nuevo si el equipo realiza una transición inactiva a inactiva antes de que transcurra todo el task_triggers del elemento de trabajo. (Use esta marca junto con TASK_FLAG_KILL_ON_IDLE_END).
TASK_FLAG_DONT_START_IF_ON_BATTERIES
El elemento de trabajo no se inicia si su equipo de destino se está ejecutando con batería.
TASK_FLAG_KILL_IF_GOING_ON_BATTERIES
El elemento de trabajo finaliza y la aplicación asociada se cierra si el equipo de destino del elemento de trabajo cambia a la batería.
TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET
El elemento de trabajo solo se ejecuta si actualmente hay una conexión a Internet válida.
Valor devuelto
El método SetFlags 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 programas deben llamar al método IPersistFile::Save después de llamar a SetFlags para actualizar las marcas.
Este método se usa para establecer esas marcas usadas por cualquier tipo de elemento de trabajo programado. Por el contrario, ITask::SetTaskFlags solo se usa para establecer marcas usadas por las tareas programadas.
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 |