Compartir a través de


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.

Nota Esta característica no está implementada actualmente.
 

Valor devuelto

El método SetFlags 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 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

Consulte también

IScheduledWorkItem

IScheduledWorkItem::GetFlags

IScheduledWorkItem::SetAccountInformation