Technical Reference Manual - InduSoft

Appendix: Built-in Scripting Language
Value
Description
0 Command was not executed successfully.
1 Command was executed successfully.
Please note that this indicates only whether the command started its execution successfully, particularly if it
is executed asynchronously. It does not indicate when or how the command finished its execution.
Examples
Start Notepad, and then immediately continue to the next line of the script:
WinExec( "C:\Windows\System32\notepad.exe", 4 )
Start MS Paint, and then immediately continue to the next line of the script:
WinExec( "C:\Windows\System32\mspaint.exe" )
Call a batch file, execute it in hidden mode, wait until it's finished before continuing, and then store the exit
code in the tag return:
WinExec( "CMD /C call C:\Temp\MyBatch.bat", 0, 1, "return" )
Call a VBScript file, execute it in hidden mode, and then immediately continue, storing the handle in the tag
handle:
WinExec( "CMD /C call C:\Temp\MyScript.vbs", 0, 0, "handle" )
Note: Calling VBScript files is not supported on Windows Embedded target systems.
WinExecIsRunning
Indicates whether a program started by the WinExec function is still running.
Function Group Execution Windows Embedded Thin Client
WinExecIsRunningModule Activity Synchronous Supported Supported Supported
Syntax
WinExecIsrunning( numHandle, "optTagReturn" )
numHandle
Handle number stored in the tag in the optStrReturnorHandle parameter of the WinExec
function.
"optTagReturn"
Tag that receives the code returned by the program executed by the WinExec function.
Returned value
0 Successful execution.
-1 Invalid parameter(s).
-2 Failed to open file. Disk is write protected or file name is invalid.
Page 624
InduSoft Web Studio