RunProgram Method

Launches an external program or opens an external document.

[VBScript]

Installer.RunProgram Path, Params, bWait

[JScript]

Installer.RunProgram(Path, Params, bWait);

Parameters

Path

Path to document or executable file.

Params

Executable file parameters (if Path is a document file, Params should be empty).

bWait

Boolean value indicating whether the installer should wait for the program to finish executing before continuing to the next installer action.

Remarks

This method allows you to launch an external executable with string parameters. It also supports the opening of document files registered on a target system. Also, hyperlink protocol is supported, so you may use it to visit a specific Web page. Refer to the documentation of a ShellExecuteEx function for more details.

Installer variables are supported in the following parameters: Path and Params. To emit the value of installer variable MyVar, use the following form: ${MyVar}.

Uninstall support

This action does not support uninstallation.

Example (VBScript)

res = Installer.ShowMessage("Do you wish to visit the ${ProductName} web site?", _

  "Finishing installation", vbYesNo+vbExclamation)

If res = vbYes Then

  Installer.RunProgram "http://www.awinstall.com/moreinfo.html", "", False

End If

Example (JScript)

res = Installer.ShowMessage("Do you wish to visit the ${ProductName} web site?",

  "Finishing installation", 4 + 48);

if (res == 6)

  Installer.RunProgram("http://www.awinstall.com/moreinfo.html", "", false);