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