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

Renvoi une copie de ce "ProcessHandle".

myObject.clone();

• (ProcessHandle) une copie de ce "ProcessHandle"

var copyOfMyObject = myObject.clone();

Renvoi 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

Returns a string representing this ProcessHandle.

myObject.toString();

• (string) a string representing this ProcessHandle

Console.print(myObject.toString());

This method is automatically called when trying to convert a ProcessHandle to a string.

Returns the process id.

myObject.id();

• (integer) the process id

Try to kill the process.

myObject.kill(killMode, timeout);

1. killMode - (KillMode) the kill mode to use
2. timeout - (integer) the timeout in milliseconds to wait when using GracefulThenForceful

• (boolean) true if the process was killed

Returns true if the process is currently running.

myObject.isRunning();

• (boolean) true if the process is currently running

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