Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Group

Utilities

Description

Starts

Start executable as an external process on the host computer. The function returns immediately, and the outputs are available by calling the function WaitExecutable.

When the option OP_EXEC_FILE_OUTPUT_STDERR is setted, the stderr outputs are separated of the stdout outputs. See WaitExecutable for more information.

When the option OP_EXEC_FILE_DETACHED is setted, the outputs are lost.

Required Control

None

Usage

processId = RtlabApi.StartExecutable(executable, arguments, options)

Input

  • executable: Path and file name of the executable.

  • arguments: Arguments of the executable.

  • options: Options to start executable. See OP_START_EXEC_DEFINE.

Output

  • processId: Process id of the executable.

Exception

  • EOK: Success.

  • OP_EXEC_FILE_START_ALREADY: An executable, which you are waiting for results, is still running.

  • OP_API_START_EXEC_FILE: Error starting the execution of the file.

Examples

None

Related Items

StopExecutable, WaitExecutable, OP_START_EXEC_DEFINE.

Modules

import RtlabApi