Método ITaskSettings::p ut_Priority (taskschd.h)

  • Artículo

Obtiene o establece el nivel de prioridad de la tarea.

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_Priority(
  int priority
);

Parámetros

priority

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 basada en un valor de Priority Class. 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. Este valor también afecta a la prioridad de memoria (consulte MEMORY_PRIORITY_INFORMATION). 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
  La prioridad de tarea 4 corresponde a la prioridad de memoria "MEMORY_PRIORITY_NORMAL(5)", de 5 a "MEMORY_PRIORITY_BELOW_NORMAL(4)" y 6 a "MEMORY_PRIORITY_MEDIUM(3)".

Al leer o escribir XML para una tarea, este valor 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