Compartir a través de


Método ITaskSettings::get_Priority (taskschd.h)

Obtiene o establece el nivel de prioridad de la tarea.

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_Priority(
  int *pPriority
);

Parámetros

pPriority

Valor devuelto

None

Observaciones

El nivel de prioridad 0 es la prioridad más alta y el nivel de prioridad 10 es la prioridad más baja. El valor predeterminado es 7. Los niveles de prioridad 7 y 8 se usan para las tareas en segundo plano y los niveles de prioridad 4, 5 y 6 se usan para tareas interactivas.

La acción de la tarea se inicia en un proceso con una prioridad que se basa en un valor de Clase de prioridad. Se usa un valor de nivel de prioridad (prioridad de subproceso) para las acciones de tarea de controlador COM, cuadro de mensaje y correo electrónico. Para obtener más información sobre los valores De clase prioridad y Nivel de prioridad, vea Programación de prioridades. En la tabla siguiente se enumeran los valores posibles para el parámetro priority y los valores de Priority Class y Priority Level correspondientes.

Prioridad de tarea Priority (clase) Nivel de prioridad
0 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL
1 HIGH_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST
2 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
3 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
4 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
5 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
6 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
7 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
8 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
9 IDLE_PRIORITY_CLASS THREAD_PRIORITY_LOWEST
10 IDLE_PRIORITY_CLASS THREAD_PRIORITY_IDLE
 

Al leer o escribir XML para una tarea, esta configuración se especifica en el elemento Priority (settingsType) del esquema del Programador de tareas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado taskschd.h
Library Taskschd.lib
Archivo DLL Taskschd.dll

Consulte también

ITaskSettings