OSLoadProgram
Function : OS Program
OSLoadProgram - Load and execute an external Program.
#include <osmisc.h>
STATUS LNPUBLIC OSLoadProgram(
char far *filename,
char far *WorkingDir,
char far *Arguments,
WORD Flags);
This function loads and executes an external Program. Use OSLoadProgram to load and execute software modules at run time.
OSLoadProgram provides C API programs with a platform-independent procedure for loading and executing a program.
Starting with Release 4.6, the command line is assumed to be in LMBCS, the Lotus Multi-Byte Character Set, and is translated to the operating system's native character set before being passed to the called program.
Parameters : Input : filename - File name of the executable program to load and execute.
WorkingDir - If "WorkingDir" is not NULL, the specified directory is made to be the current directory before program execution, else it is the directory that the program lives in.
Arguments - Optional command line arguments to be used when launching the program. The command line arguments are translated from LMBCS to the native character set.
Flags - Define how to execute the program. Use one of the OS_LOADPROG_xxx flags symbolic values.
Output : (routine) - Completion status of the operation, NOERROR if successful.
Sample Usage :
STATUS error;
char ProgramPath[MAXPATH];
WORD Flags = OS_LOADPROG_BACKGROUND | OS_LOADPROG_ICONIC |
OS_LOADPROG_DEBUG;
/* Set your program pathname ProgramPath */
< ..............>
/* Load the program with "-w" command line argument: */
error = OSLoadProgram(ProgramPath, NULL, "-w", Flags);