Méthode SetPriority de la classe Win32_Process

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

Cette rubrique utilise la syntaxe MOF (Managed Object Format). 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é [in]

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

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 préemptés par les threads d’un processus qui s’exécute dans une classe de priorité supérieure, par exemple, un économiseur d’écran. La classe de priorité inactive est héritée par les processus enfants.

Inférieur à la normale (16384)

Indique un processus dont la priorité est supérieure à IDLE_PRIORITY_CLASS, mais inférieure à NORMAL_PRIORITY_CLASS.

Normal (32)

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

Au-dessus de la normale (32768)

Indique un processus dont la priorité est supérieure à NORMAL_PRIORITY_CLASS, mais inférieure à HIGH_PRIORITY_CLASS.

Priorité élevée (128)

Spécifié pour un processus qui effectue des tâches critiques 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 doit répondre rapidement lorsqu’elle est appelée par l’utilisateur, quelle que soit la charge sur le système d’exploitation. Utilisez un soin extrême lors de l’utilisation de la classe à priorité élevée, car une application de classe à haute priorité peut utiliser la quasi-totalité du 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 préemptent 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 pendant plus d’un intervalle très court peut empêcher le vidage des caches de disque ou la non-réponse d’une souris.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante, ou une autre valeur pour indiquer une erreur. Pour obtenir des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Achèvement réussi (0)

Accès refusé (2)

Privilège insuffisant (3)

Échec inconnu (8)

Chemin introuvable (9)

Paramètre non valide (21)

Autres (22 4294967295)

Notes

Pour définir la priorité sur Realtime, l’appelant doit avoir SeIncreaseBasePriorityPrivilege (SE_INC_BASE_PRIORITY_PRIVILEGE). Sans ce privilège, la priorité la plus élevée peut être définie sur Priorité élevée.

Exemples

L’exemple VbScript de modification de la priorité d’un processus en cours d’exécution modifie la priorité d’un instance en cours d’exécution de Notepad.exe de Normal à 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	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Classes du système d’exploitation

Win32_Process