Function Reference


ProcessClose

Terminates a named process.

ProcessClose ( "process" )

Parameters

process The name or PID of the process to terminate.

Return Value

Success: 1.
Failure: 0 and sets the @error flag to non-zero.
@error: 1 = OpenProcess failed
2 = AdjustTokenPrivileges Failed
3 = TerminateProcess Failed
4 = Cannot verify if process exists
@extended: sets to Windows API GetLastError()

Remarks

Process names are executables without the full path, e.g., "notepad.exe" or "winword.exe"

If multiple processes have the same name, the one with the highest PID is terminated--regardless of how recently the process was spawned.

PID is the unique number which identifies a Process. A PID can be obtained through the ProcessExists() or Run() commands.

The process is polled approximately every 250 milliseconds.

Related

ProcessExists, ProcessList, ProcessWait, ProcessWaitClose, Run, RunAs, Shutdown, WinClose, WinKill

Example

Example()

Func Example()
        ; Run Notepad
        Local $iPID = Run("notepad.exe")

        ; Wait 10 seconds for the Notepad window to appear.
        WinWait("[CLASS:Notepad]", "", 10)

        ; Wait for 2 seconds.
        Sleep(2000)

        ; Close the Notepad process using the PID returned by Run.
        ProcessClose($iPID)
EndFunc   ;==>Example