Method RunWait

AutoIt X

Method Reference


RunWait

Runs an external program and pauses script execution until the program finishes

RunWait "filename" [, "workingdir" [, flag]]

Parameters

filename The name of the executable (EXE, BAT, COM, PIF) to run.
workingdir 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: Returns the exit code of the program that was run.
Failure: see Remarks.

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.

The error property is set to 1 as an indication of failure.

Related

ProcessWait, ProcessWaitClose, RunAs, RunAsWait, RunWait

Example


Set oAutoIt = WScript.CreateObject("AutoItX3.Control")
val = oAutoIt.RunWait("Notepad.exe", "C:\WINDOWS", oAutoIt.SW_MAXIMIZE)

' script waits until Notepad closes
WScript.Echo "Program returned with exit code:" & val