Méthode SetPriority de la _ classe Process Win32

La méthode de classe WMI SetPriority tente de modifier la priorité d’exécution du processus.

Cette rubrique utilise la syntaxe format MOF (MOF). Pour plus d’informations sur l’utilisation de cette méthode, consultez appel d’une méthode.

Syntaxe

uint32 SetPriority(
  [in] sint32 Priority
);

Paramètres

Priorité [ dans]

Nouvelle classe de priorité pour le processus. Notez que ces valeurs sont différentes de celles explicitement indiquées dans la propriété Priority du _ processus Win32.

Inactif (64)

Spécifié pour un processus avec des threads qui s’exécutent uniquement lorsque le système est inactif. Les threads du processus sont reportés par les threads d’un processus qui s’exécutent dans une classe de priorité plus élevée, par exemple un économiseur d’écran. La classe idle-priority est héritée par les processus enfants.

Inférieure à la normale (16384)

Indique un processus qui a une priorité supérieure à la _ _ classe de priorité inactive, mais qui se trouve en dessous de la _ _ classe de priorité normale.

Normal (32)

Spécifié pour un processus sans besoins de planification spéciaux.

Au-dessus de la normale (32768)

Indique un processus qui a une priorité supérieure à la _ _ classe de priorité normale, mais qui se trouve en dessous de la _ _ classe de priorité élevée.

Haute priorité (128)

Spécifié pour un processus qui exécute des tâches critiques à l’heure qui doivent être exécutées immédiatement. Les threads du processus prévalent sur les threads de processus de classe de priorités normale ou inactive. Par exemple, la Liste des tâches, qui doit répondre rapidement lorsqu’elle est appelée par l’utilisateur, quelle que soit la charge sur le système d’exploitation. Soyez extrêmement vigilant lorsque vous utilisez la classe de priorité élevée, car une application de classe de priorité élevée peut utiliser presque tout le temps processeur disponible.

Temps réel (256)

Spécifié pour un processus qui a la priorité la plus élevée possible. Les threads du processus devancent les threads de tous les autres processus, y compris les processus du système d’exploitation qui effectuent des tâches importantes. Par exemple, un processus en temps réel qui s’exécute depuis plus d’un intervalle très court peut empêcher le vidage du cache disque ou la non-réponse d’une souris.

Valeur de retour

Retourne l’une des valeurs répertoriées dans la liste suivante, ou une valeur différente pour indiquer une erreur. Pour obtenir d’autres codes d’erreur, consultez constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir les valeurs de HRESULT générales, consultez codes d’erreur système.

Achèvement réussi (0)

Accès refusé (2)

Privilèges insuffisants (3)

Échec inconnu (8)

Chemin introuvable (9)

Paramètre non valide (21)

Autre (22 4294967295)

Notes

pour définir la priorité en temps réel, l’appelant doit disposer de SeIncreaseBasePriorityPrivilege (privilège de _ priorité de _ BASE _ _ SE INC). Sans ce privilège, la priorité la plus élevée peut être définie sur la priorité haute.

Exemples

L’exemple de modification de la priorité d’un processus en cours d’exécution VBScript modifie la priorité d’une instance en cours d’exécution de Notepad.exe de la normale à au-dessus de la normale.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

Classes du système d’exploitation

_Processus Win32