Partager via


Méthode ITask ::GetPriority (mstask.h)

[[Cette API peut être modifiée ou indisponible dans les versions ultérieures du système d’exploitation ou du produit. Utilisez plutôt les interfaces Du planificateur de tâches 2.0 .] ]

Cette méthode récupère la priorité de la tâche.

Syntaxe

HRESULT GetPriority(
  [out] DWORD *pdwPriority
);

Paramètres

[out] pdwPriority

Pointeur vers un DWORD qui contient la priorité de la tâche en cours. La valeur de priorité détermine la fréquence et la durée des tranches de temps d’un processus. Cela s’applique uniquement aux systèmes d’exploitation Windows Server 2003, Windows XP et Windows 2000. Il est tiré de la classe de priorité CreateProcess et peut être l’un des indicateurs suivants (dans l’ordre décroissant de la priorité de planification des threads) :

  • REALTIME_PRIORITY_CLASS
  • HIGH_PRIORITY_CLASS
  • NORMAL_PRIORITY_CLASS
  • IDLE_PRIORITY_CLASS

Valeur retournée

La méthode GetPriority retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
L'opération a réussi.
E_INVALIDARG
Les arguments ne sont pas valides.
E_OUTOFMEMORY
Mémoire disponible insuffisante.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mstask.h
Bibliothèque Mstask.lib
DLL Mstask.dll

Voir aussi

Itask

SetPriority