Load and execute new child processes.
intptr_t _execlpe( const char *cmdname, const char *arg0, ... const char *argn, NULL, const char *const *envp ); intptr_t _wexeclpe( const wchar_t *cmdname, const wchar_t *arg0, ... const wchar_t *argn, NULL, const wchar_t *const *envp );
- Path of file to execute.
- arg0, ... argn
- List of pointers to parameters.
- Array of pointers to environment settings.
If successful, these functions do not return to the calling process. A return value of –1 indicates an error, in which case the errno global variable is set.
|E2BIG||The space required for the arguments and environment settings exceeds 32 K.|
|EACCES||The specified file has a locking or sharing violation.|
|EMFILE||Too many files open (the specified file must be opened to determine whether it is executable).|
|ENOENT||File or path not found.|
|ENOEXEC||The specified file is not executable or has an invalid executable-file format.|
|ENOMEM||Not enough memory is available to execute the new process; or the available memory has been corrupted; or an invalid block exists, indicating that the calling process was not allocated properly.|
See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, return codes.
Each of these functions loads and executes a new process, passing each command-line argument as a separate parameter and also passing an array of pointers to environment settings. These functions use the PATH environment variable to find the file to execute.
|Function||Required header||Optional headers||Compatibility|
|_execlpe||<process.h>||<errno.h>||Win 98, Win Me, Win NT, Win 2000, Win XP|
|_wexeclpe||<process.h> or <wchar.h>||<errno.h>||Win NT, Win 2000, Win XP|
For additional compatibility information, see Compatibility in the Introduction.
All versions of the C run-time libraries.
See the example in _exec, _wexec Functions.