Funktionreferenz


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