ProcessClose
Beschreibung anzeigen in
Beendet den genannten Prozess.
ProcessClose ( "process" )
Parameter
| process | Der Name oder die PID des Prozesses, der beendet werden soll. |
Rückgabewert
| Erfolg: | 1. |
| Fehler: | 0 und setzt @error auf einen Wert ungleich 0. |
| @error: | 1 = OpenProcess fehlgeschlagen 2 = AdjustTokenPrivileges fehlgeschlagen 3 = TerminateProcess fehlgeschlagen 4 = Es konnte nicht sichergestellt werden, ob der Prozess existiert |
| @extended: | wird auf Win API GetLastError() gesetzt |
Bemerkungen
Die Prozessnamen sind die ausführbaren Dateien ohne den kompletten Pfad, also z.B. "notepad.exe" oder "winword.exe".
Wenn mehrere Prozesse den gleichen Namen haben, dann wird derjenige mit der höchsten PID beendet - egal, wann er gestartet wurde.
Die PID ist eine eindeutige Zahl, die einen Prozess indentifiziert. Die PID kann über die Rückgabewerte der Funktionen ProcessExists() oder Run() ermittelt werden.
Der Prozess wird ungefähr alle 250 Millisekunden abgefragt.
Verwandte Funktionen
ProcessExists, ProcessList, ProcessWait, ProcessWaitClose, Run, RunAs, Shutdown, WinClose, WinKill
Beispiel
Example()
Func Example()
; Startet den Editor
Local $iPID = Run("notepad.exe")
; Wartet maximal 10 Sekunden bis das Editorfenster erscheint.
WinWait("[CLASS:Notepad]", "", 10)
; Wartet 10 Sekunden
Sleep(2000)
; Schließt den Editorprozessf durch die Verwendung der von Run zurückgegebenen PID.
ProcessClose($iPID)
EndFunc ;==>Example