ExecuteOSProgram

Prototype

Matrix ExecuteOSProgram( String sPathName, String sArguments, boolean bWait )

Return Value

The return value is 1 on success or 0 on failure.

Parameters

String sPathName
The program to execute. If sPathName does not contain a path to the program file, Windows will search for the program file.

String sArguments
Any arguments (parameters) to be passed to the program. If an argument is a filename/pathname that might contain space characters, enclose the argument in double quotation marks.

boolean bWait
If bWait is true, the module waits for the program to finish executing before it returns. If bWait is false, the module returns as soon as the program begins executing.

Remarks

This module executes a program on the client computer.

Example

run GetInstallationDirectory( path );
filespec = path + "Programs\Samples\Module Demos\Windows Operating System\DemoExecuteOSProgram.sx";
arguments = '"' + filespec + '"';
ok = ExecuteOSProgram( "notepad.exe", arguments, false );
if ok then
    print "OK";
else
    print "Function failed";