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

# TPROCESS.Execute

Execute the program with the given options

## Declaration

Source position: processbody.inc line 113

`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 occurred). If this option is not given, the call returns immediately, 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 whether 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.
TProcess.ExitCode |  | Exit code of the process

Documentation generated on: May 14 2021