Core Function RunWait

RunWait( <file>, <workdir>, <flag> )

Description

Runs an external program and waits until the program finishes.

Parameters

file

The name of the executable (EXE, BAT, COM, or PIF) to run.

workdir

Optional; The working directory.

flag

Optional; The "show" flag of the executed program:

@SW_HIDE = Hidden window
@SW_MINIMIZE = Minimized window
@SW_MAXIMIZE = Maximized window

Return Value

Success: The PID of the process that was launched.

Failure: 0.

Remarks

After running the requested program the script pauses until the program terminates. To run a program and then immediately continue script execution use the Run function instead.

Some programs will appear to return immediately even though they are still running; these programs spawn another process - you may be able to use the ProcessWaitClose function to handle these cases.

Example

$val = RunWait('Notepad.exe', 'C:\WINDOWS', @SW_SHOWNORMAL);
// script waits until Notepad closes
MsgBox("Program returned with exit code: $val");