EXITCODE property (System)

Returns the exit code of the last process that was executed by the RUNWIN method.

This property is a numeric value. When a process exits it normally returns a value to indicate the status of the program when it closed. By convention a successful execution returns an exit code of 0, but this is not enforced.

When executing a process with RUNWIN in an asynchronous fashion this property is only valid when accessed from the specified callback routine.

If several asynchronous tasks are executed in a simultaneous fashion then the valid of the EXITCODE property may not be accurate when accessed in the callback – as it is a global property it may be overwritten by a different, subsequent process exit before the callback can be executed.

 
// Execute an asynchronous process with a callback stored procedure
// defined.

CmdLine = "c:\devtools\myproc.exe /D=34 /A=Wibble"
CmdArgs = ""
CmdArgs<1> = 1                    ; // Show Normal, Async
CmdArgs<2> = "MY_CALLBACK_PROC"   ; // Stored Proc to call on exit
CndArgs<3> = "myproc"             ; // Argument to pass to proc
CmdArgs<4> = Drive()              ; // Working Directory
Call Exec_Method( "SYSTEM", "RUNWIN", CmdLine, CmdArgs )

// ================================================================
//=================================================================
// Example stored callback proc

Compile Subroutine MY_CALLBACK_PROC( CallBackArg )
If ( CallBackArg == "myproc" ) Then
   // We got a callback fom "myproc.exe" - Get its EXITCODE and log it
   ExitCode = Get_Property( "SYSTEM", "EXITCODE" )
   Call UpdateLog( "MyProc.exe returned " : ExitCode )
End
Return

RUNWIN method.