ProcessHandle [En cours de Traduction Wismerheal][WSL]

Cet objet représente un processus en cours d’exécution.

Fonction de Construction.

var myObject = new ProcessHandle();

var myObject = new ProcessHandle(otherProcessHandle);

var myObject = new ProcessHandle(processId);

1. otherProcessHandle - (ProcessHandle) autre "ProcessHandle" à copier
2. processId - (integer) identifiant de processus pour gérer/contrôler celui-ci

• (ParameterTypeError) type de paramètre incorrect
• (ParameterCountError) nombre de paramètre incorrect

Créer un "ProcessHandle" représentant un processus invalide.

var myObject = new ProcessHandle();

Créer un "ProcessHandle" représentant une copie d' otherProcessHandle.

var myObject = new ProcessHandle(otherProcessHandle);

Créer un "ProcessHandleé lié au processus disposant de l'identifiant (id) 1337.

var myObject = new ProcessHandle(1337);

Renvoie une copie de ce "ProcessHandle".

myObject.clone();

• (ProcessHandle) une copie de ce "ProcessHandle"

var copyOfMyObject = myObject.clone();

Renvoie vrai si ce "ProcessHandle" et un autre se réfèrent au même processus.

myObject.equals(other);

1. other - (ProcessHandle) autre "ProcessHandle"

• (bool) vrai si other se réfère au même processus

if(myFirstObject.equals(mySecondObject))
	//Do something

Renvoie une chaîne représentant ce "ProcessHandle".

myObject.toString();

• (string) une chaîne représentant ce "ProcessHandle"

Console.print(myObject.toString());

Cette méthode est appelée automatiquement quand vous tentez de convertir un "ProcessHandle" en chaîne.

Renvoie l'identifiant du processus (id).

myObject.id();

• (integer) l'identifiant du processus (id)

Tenter d'arrêter un processus.

myObject.kill(killMode, timeout);

1. killMode - (KillMode) le mode d'arrêt à utiliser
2. timeout - (integer) le délai d'attente en millisecondes quand on utilise "GracefulThenForceful"

• (boolean) vrai si le processus a été arrêté.

Renvoie vrai si le processus est actuellement en exécution.

myObject.isRunning();

• (boolean) vrai si le processus est actuellement en exécution

Renvoie la commande qui fut utilisée pour lancer le processus.

myObject.command();

• © la commande qui fut utilisée pour lancer le processus

• (OpenProcessError) ne parvient pas à ouvrir le processus (Windows)
• (GetModuleFilenameError) ne parvient pas à obtenir le nom de fichier du module unable to get the module (Windows)
• (GetProcessError) ne parvient pas à obtenir la commande du processus (Linux)

Renvoie la priorité de ce processus.

myObject.priority();

• (Priority) la priorité du processus

• (OpenProcessError) ne parvient pas à ouvrir le processus (Windows)
• (GetPriorityClassError) ne parvient pas à obtenir la classe de la priorité (Windows)
• (OperatingSystemError) Ceci n'est pas disponible pour ce système d'exploitation (Linux)

Cette Méthode fonctionne seulement sur Windows du fait que Linux ne dispose pas du principe de priorité de processus.

Politique à respecter pour utiliser la tentative d'arrêt d'un processus.

1. Graceful (Élégante): Linux: envoi un signal Windows SIGTERM: ferme toutes le fenêtres appartenant au processus
2. Forceful (Brutale): Linux: envoi un signal Windows SIGKILL: utilise "TerminateProcess" (arrêter processus) pour arrêter le processus
3. GracefulThenForceful [Élégante puis brutale): Tente d'arrêter le processus en utilisant la méthode élégante puis, après le délai d'attente, utilisera la méthode brutale.

La priorité d'un processus.

1. AboveNormal: en dessous de la normale
2. BelowNormal: au dessus de la normale
3. High: haute
4. Idle: en attente / au repos
5. Normal: normale
6. Realtime: en temps réel