Runs an external program.
Run ( "program" [, "workingdir" [, show_flag [, opt_flag]]] )
|program||The full path of the program (EXE, BAT, COM, or PIF) to run (see remarks).|
|workingdir||[optional] The working directory. Blank ("") uses the current working directory. This is not the path to the program.|
|show_flag|| [optional] The "show" flag of the executed program:
@SW_HIDE = Hidden window (or Default keyword)
@SW_MINIMIZE = Minimized window
@SW_MAXIMIZE = Maximized window
|opt_flag|| [optional] Controls various options related to how the parent and child process interact.
0x1 ($STDIN_CHILD) = Provide a handle to the child's STDIN stream
0x2 ($STDOUT_CHILD) = Provide a handle to the child's STDOUT stream
0x4 ($STDERR_CHILD) = Provide a handle to the child's STDERR stream
0x8 ($STDERR_MERGED) = Provides the same handle for STDOUT and STDERR. Implies both $STDOUT_CHILD and $STDERR_CHILD.
0x10 ($STDIO_INHERIT_PARENT) = Provide the child with the parent's STDIO streams. This flag can not be combined with any other STDIO flag. This flag is only useful when the parent is compiled as a Console application.
0x10000 ($RUN_CREATE_NEW_CONSOLE) = The child console process should be created with it's own window instead of using the parent's window. This flag is only useful when the parent is compiled as a Console application.
|Success:||the PID of the process that was launched.|
|Failure:||0 and sets the @error flag to non-zero.|
Example() Func Example() ; Run Notepad with the window maximized. Local $iPID = Run("notepad.exe", "", @SW_SHOWMAXIMIZED) ; Wait 10 seconds for the Notepad window to appear. WinWait("[CLASS:Notepad]", "", 10) ; Wait for 2 seconds. Sleep(2000) ; Close the Notepad process using the PID returned by Run. ProcessClose($iPID) EndFunc ;==>Example