Funktionsreferenz

ProcessList

Gibt ein Array zurück, das die aktuell laufenden Prozesse auflistet (Namen und PIDs).

ProcessList ( ["name"] )

Parameter

name	[optional] Wird ein "Name" angegeben, werden nur Prozesse dieses Namens zurückgegeben.

Rückgabewert

Erfolg:	Ein Array der Prozessnamen und -PIDs wird zurückgegeben (siehe Bemerkungen).
Fehler:	@error wird auf 1 gesetzt, falls die Liste nicht erstellt werden kann.

Bemerkungen

Das zurückgegebene Array ist 2-dimensional und wie folgt aufgebaut:
$array[0][0] = Anzahl der Prozesse
$array[1][0] = Name des 1. Prozesses
$array[1][1] = Process ID (PID) des 1. Prozesses
$array[2][0] = Name des 2. Prozesses
$array[2][1] = Process ID (PID) des 2. Prozesses
...
$array[n][0] = Name des n-ten Prozesses
$array[n][1] = Process ID (PID) des n-ten Prozesses

Die Liste kann leer sein, wenn $array[0][0] = 0. In diesem Fall wird @error nicht gesetzt.

[Anm. d. Ü.]
Diese Funktion zeigt keine Prozesse von alten 16-Bit Programmen die unter der Windowseigenen "Windows NT Virtual DOS Machine" (NTVDM) ausgeführt werden. Solche Prozesse sind an einem führenden Leerzeichen im Taskmanager erkennbar.

Verwandte Funktionen

ProcessClose, ProcessExists, ProcessSetPriority, ProcessWait, ProcessWaitClose, ProcessGetStats, WinGetProcess

Beispiel

; Listet alle Prozesse
$list = ProcessList()
for $i = 1 to $list[0][0]
msgbox(0, $list[$i][0], $list[$i][1])
next

; Listet nur Prozesse von notepad.exe
$list = ProcessList("notepad.exe")
for $i = 1 to $list[0][0]
msgbox(0, $list[$i][0], $list[$i][1])
next