_execle、_wexecle
加载和执行新的子进程。
重要
此 API 不能用于在 Windows 运行时 中执行的应用程序。有关更多信息,请参见不支持 /ZW 的 CRT 函数。
intptr_t _execle(
const char *cmdname,
const char *arg0,
... const char *argn,
NULL,
const char *const *envp
);
intptr_t _wexecle(
const wchar_t *cmdname,
const wchar_t *arg0,
... const wchar_t *argn,
NULL,
const char *const *envp
);
参数
cmdname
要执行的文件的路径。arg0, ...argn
指向参数的指针数组。envp
指向环境设置的指针的数组。
返回值
如果成功,这些函数不返回到调用进程。 返回值 –1 表示错误,在此情况下将会设置 errno 全局变量。
errno 值 |
说明 |
---|---|
E2BIG |
参数所需的空间和环境设置超过 32 KB。 |
EACCES |
指定的文件具有锁定或共享冲突。 |
EINVAL |
无效参数。 |
EMFILE |
打开太多文件。(必须打开指定的文件以确定它是否是可执行文件。) |
ENOENT |
未找到文件或路径。 |
ENOEXEC |
指定的文件不是可执行文件或者有无效的可执行文件格式。 |
ENOMEM |
没有足够的内存可用于执行更新进程;可用内存损坏;或存在无效的块,指示调用进程未正确地分配。 |
有关返回代码的详细信息,请参阅 _doserrno、errno、_sys_errlist 和 _sys_nerr。
备注
每一个函数加载并且执行一个新的进程,把每一个命令行的参数作为独立的参数进行传递,并且传递一个数组指针给环境设置。
_execle 函数验证其参数. 如果 cmdname 或 arg0 为空指针或空字符串,这些函数将触发无效参数处理程序,正如参数验证 所述。 如果允许执行继续,则这些功能将 EINVAL 设置为 errno 并返回 -1。 不启动任何新进程。
要求
功能 |
必需的标头 |
可选标头 |
---|---|---|
_execle |
<process.h> |
<errno.h> |
_wexecle |
<process.h> 或 <wchar.h> |
<errno.h> |
有关详细信息,请参阅兼容性。
示例
请参见 _exec、_wexec 函数中的示例。