Método ITask::GetPriority (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 recupera la prioridad de la tarea.

Sintaxis

HRESULT GetPriority(
  [out] DWORD *pdwPriority
);

Parámetros

[out] pdwPriority

Puntero a un DWORD que contiene la prioridad de la tarea actual. El valor de prioridad 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. Se toma de la clase prioridad CreateProcess y puede 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 GetPriority 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.
E_OUTOFMEMORY	No hay suficiente memoria disponible.

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

ITask

SetPriority