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 |