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 - (entier) 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();

• (entier) 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 - (entier) 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

Returns the command that was used to start this process.

myObject.command();

• (string) the command that was used to start this process

• (OpenProcessError) unable to open the process (Windows)
• (GetModuleFilenameError) unable to get the module filename (Windows)
• (GetProcessError) unable to get the process command (Linux)

Returns the priority of this process.

myObject.priority();

• (Priority) the process priority

• (OpenProcessError) unable to open the process (Windows)
• (GetPriorityClassError) unable to get priority class (Windows)
• (OperatingSystemError) this is not available on this operating system (Linux)

This method only works on Windows, because Linux doesn't have any concept of process priority.

Policy to use when trying to kill a process.

1. Graceful: Linux: send a SIGTERM signal Windows: close all windows owned by this process
2. Forceful: Linux: send a SIGKILL signal Windows: use TerminateProcess to kill this process
3. GracefulThenForceful: try to kill the process using the graceful technique, wait for timeout and kill it using the forceful technique

A process priority.

1. AboveNormal: above normal
2. BelowNormal: below normal
3. High: high
4. Idle: idle
5. Normal: normal
6. Realtime: realtime