Compartir a través de

Método ITask::SetPriority (mstask.h)

  • Artículo

[[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 . ]

Este método establece la prioridad de la tarea.

Sintaxis

HRESULT SetPriority(
  [in] DWORD dwPriority
);

Parámetros

[in] dwPriority

DWORD que especifica la prioridad de la tarea actual. La prioridad de una tarea determina la frecuencia y la longitud de los intervalos de tiempo de un proceso. Esto solo se aplica a los sistemas operativos Windows Server 2003, Windows XP y Windows 2000. Estos valores se toman de la clase prioridad CreateProcess y pueden ser una de las marcas siguientes (en orden descendente de prioridad de programación de subprocesos):

  • REALTIME_PRIORITY_CLASS
  • HIGH_PRIORITY_CLASS
  • NORMAL_PRIORITY_CLASS
  • IDLE_PRIORITY_CLASS

Valor devuelto

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

Comentarios

Después de establecer la prioridad de una tarea, llame a IPersistFile::Save para guardar el objeto de tarea modificado en el disco.

Ejemplos

Para obtener más información y un ejemplo de cómo establecer la prioridad de una tarea, vea Ejemplo de código de C/C++: Establecer prioridad de tarea.

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

Consulte también

GetPriority

ITask