Método ITask::SetPriority (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 . ]

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