8.4. RxWinExec (Windows only)
>>-RxWinExec(-cmdline--+------------+--)-----------------------><
+-,--cmdshow-+
Starts (executes) the application as specified in cmdline.
Parameters:
- cmdline
A string containing a file name and optional parameters for the application to be executed. If the name of the executable file in
cmdline does not contain a directory path, RxWinExec searches for the executable file in this sequence:
- 1
The directory from which Object Rexx was loaded.
- 2
The current directory.
- 3
The Windows system directory.
- 4
The Windows directory.
- 5
The directories listed in the PATH environment variable.
- cmdshow
Specifies how a Windows-based application window is to be shown. For a non-Windows-based application, the PIF file, if any, for the application determines the window state.
- SHOWNORMAL
Activates and displays a window.
- SHOWNOACTIVATE
Displays the window while the current active window remains active.
- SHOWMINNOACTIVE
Displays the window as a minimized window, the current active window remains active.
- SHOWMINIMIZED
Activates the window and displays it as a minimized window.
- SHOWMAXIMIZED
Activates the window and displays it as a maximized window.
- HIDE
Hides the window and activates another window.
- MINIMIZE
Minimizes the specified window and activates the next top-level window in the Z order.
Return codes:
If the application is started successfully, the process id (PID) is returned. If an error occurs the returned value is less than 32.
Error return codes correspond to a Windows System Error code (
Section 8.1, “A Note on Error Codes”). If the Windows system error code is greater than 32 it is negated. This is to prevent confusion between a legitimate error code and a PID.
Some common error returns for this function are as follows.
- 2
The specified file was not found.
- 3
The specified path was not found.
- 11
The EXE file is invalid.
- -53
The network path is invalid.
