company logo

BaseContext :: executeProgram - Run executable binary

The function calls an executable file at location passed in sProgramPath in a new process. The new process will run asynchronously to the current process.

Before calling the process, options defined in path and parameters are replaced by current option values. Options have to be enclosed in %..%.

When the context handle does not refer to a valid context instance the function throws an exception.

Return value:   - internal feature (not documented) (   )

Implementation overview

Implementation details

  1. Calling program with parameter list
    BaseContext  :: executeProgram ( odaba::String &sProgramPath, odaba::StringList &sParmList )

    Parameters are passed to the program via StringList ( sParamList ). Depending on the operating system, the string list is converted to a parameter string (Windows). Parameters containing spaces will be quoted with double quotes, when not yet quoted.

    • sProgramPath - Program path

      The program path refers to an executable file. The path contains the folder hierarchy and the file name (including extension).

    • sParmList - Parameter list

      Parameters passed in a string list. In some cases, parameters containing spaces have to be quoted.

    2. to list
  2. Calling program with parameters
    BaseContext  :: executeProgram ( odaba::String &sProgramPath, odaba::String &sParameter1, odaba::String &sParameter2, odaba::String &sParameter3, odaba::String &sParameter4, odaba::String &sParameter5 )
    • sProgramPath - Program path

      The program path refers to an executable file. The path contains the folder hierarchy and the file name (including extension).

    • sParameter1 - String parameter
    • sParameter2 - String parameter
    • sParameter3 - String parameter
    • sParameter4 - String parameter
    • sParameter5 - String parameter
    3. to list
to top previous next upper table of contents Comment