xpxSpawnProcessEx

FUNCTION xpxSpawnProcessEx(mode                         : INTEGER;
                           executableName               : STRING;
                           commandLineArguments         : SET OF STRING;
                           environmentVariables         : SET OF STRING;
                           VAR spawnFunctionReturnValue : INTEGER;             
                           VAR errnoValue               : INTEGER)
                           rstat                        : INTEGER;

This function starts the execution of the specified program and it's an "direct" implements the function _spawnve in the "standard" C library.

Arguments

1	Type	Name	Comment
2	INTEGER	mode	XPX_P_WAIT : This is a synchronous call to the given process XPX_P_NOWAIT : asynchronous calls XPX_P_NOWAITO : asynchronous calls In addition to these, there are two more option that are not available directly to the user, but can be used through their direct integer code. _P_OVERLAY --> integer code = 2 --> Overlays a calling process with a new process, destroying the calling process (same effect as _exec calls). _P_DETACH --> integer code = 4 --> Continues to execute the calling process; the new process is run in the background with no access to the console or keyboard. Calls to _cwait against the new process fail (asynchronous _spawn).
3	STRING	executableName	the name of the program or ".exe" file to be started.
4	SET OF STRING	commandLineArguments	a set of strings that specifies the "command line arguments" to the actual program to be started. This argument may be INDETERMINATE.
5	SET OF STRING	environmentVariables	a set of strings that specifies the environment variables to be defined for the actual program to be started. This argument may be INDETERMINATE
6	INTEGER	spawnFunctionReturnValue	returned value from the actual _spawnve function
7	INTEGER	errnoValue	receives the "exit value" from the actual started program. This argument may be INDETERMINATE.

Return Value

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_XPX_Return_Value'.

Options

Example

LOCAL
      case_name            : STRING := 'Case 01, testing xpxSpawnProcess';
      case_no              : INTEGER := 1;
      ok                   : LOGICAL := TRUE;
      mode                 : INTEGER;
      executableName       : STRING;
      commandLineArguments : SET OF STRING;
      environmentVariables : SET OF STRING;
      exitStatus           : INTEGER;
      rstat                : INTEGER;
    END_LOCAL;
 
    -- -----------------------------
    --  1a. Testing xpxSpawnProcess.
    -- -----------------------------
    trace(case_no, '1a. Testing xpxSpawnProcess');
    mode := XPX_P_WAIT;
 
    executableName := 'X:/terje/testParams.exe';
    commandLineArguments[0] := 'one';
    commandLineArguments[1] := 'two';
    commandLineArguments[2] := 'three';
    environmentVariables[0] := 'PATH=X:\terje';
 
    rstat := xpxSpawnProcess(mode, executableName, commandLineArguments, environmentVariables, exitStatus);
    trace_error(::CL::, rstat, ok);
    ok := CheckValueExists(exitStatus, ::CL::) AND ok;
    ok := (exitStatus = 0) AND ok;
    xpxPrintf('* exitStatus = %d\n', exitStatus);

xpxSpawnProcessEx

Arguments

Return Value

Options

Example

See also

Filter by label