[Overview][Types][Classes][Index] | Reference for unit 'process' (#fcl)

# TProcess.Execute

Execute the program with the given options

## Declaration

Source position: process.pp line 104

`public procedure TProcess.Execute; virtual;`

## Description

Execute actually executes the program as specified in CommandLine, applying as much as of the specified options as supported on the current platform.

If the poWaitOnExit option is specified in Options, then the call will only return when the program has finished executing (or if an error occured). If this option is not given, the call returns immediatly, but the WaitOnExit call can be used to wait for it to close, or the Running call can be used to check whether it is still running.

The TProcess.Terminate call can be used to terminate the program if it is still running, or the Suspend call can be used to temporarily stop the program's execution.

The ExitStatus function can be used to check the program's exit status, after it has stopped executing.

## Errors

On error a EProcess exception is raised.

## See also

TProcess.Running |  | Determines wheter the process is still running.
TProcess.WaitOnExit |  | Wait for the program to stop executing.
TProcess.Terminate |  | Terminate a running process
TProcess.Suspend |  | Suspend a running process
TProcess.Resume |  | Resume execution of a suspended process
TProcess.ExitStatus |  | Exit status of the process.

The latest version of this document can be found at lazarus-ccr.sourceforge.net.