Loads a binary image and spawns it as a task.
Item LoadProgram(char *cmdLine);
This function loads an executable file from disk and launches a new task to execute the code.
You give this function a command line to interpret. The first component of the command line is taken as the name of the file to load. The entirety of the command line is passed to the new task as argc and argv in the main()
function. The filename component of the command line specifies either a fully qualified pathname, or a pathname relative to the current directory.
The priority of the new task is identical to the priority of the current task. If you wish the task to have a different priority, you must use the LoadProgramPrio()
function instead.
If a priority was given to the executable being launched using the modbin utility, then the priority that was specified to modbin will be used for the new task, and not the current priority.
The Item number of the newly created task, or a negative error code if the task could not be created.
Folio call implemented in file folio V20.
filefunctions.h
LoadProgramPrio
(), LoadCode(), ExecuteAsThread()