_spawnvpe, _wspawnvpe

重要

此 API 不能在运行时的窗口执行的应用程序。有关更多信息,请参见 CRT 函数不支持与 /ZW

intptr_t _spawnvpe(
   int mode,
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wspawnvpe(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

参数

  • mode
    调用执行模式处理

  • cmdname
    要执行的文件路径

  • argv
    某些给参数的指针。 参数 argv[0] 通常是指向一个路径在实地址模式或给过程名在保护模式和 argv[1] 通过 argv[n]是指向窗体新的字符串) 参数列表。 参数 argv[n +1] 必须是标记末尾的 NULL 指针参数列表。

  • envp
    某些到环境中的指针

返回值

从同步 _spawnvpe 或 _wspawnvpe (对于 mode指定的_P_WAIT 的返回值) 作为退出状态的更新过程。 从异步 _spawnvpe 或 _wspawnvpe 的返回值 (有关 mode或 _P_NOWAITO 指定的_P_NOWAIT ) 是处理句柄。 如果处理通常,已停止退出状态为 0。 如果给定进程专门调用与非零参数,的 exit 实例可以设置退出状态到一个非零值。 如果更新过程没有显式设置正退出状态,就象退出状态指示异常退出以 + 中成对或中断。 返回值– 1 表示错误 (更新过程不启动)。 在这种情况下,errno 设置为下列值之一:

  • E2BIG
    参数列表超过 1024 个字节

  • EINVAL
    mode 无效的参数

  • ENOENT
    未找到文件或路径

  • ENOEXEC
    使用指定的文件不可执行文件也没有无效可执行 (pe) 文件格式

  • ENOMEM
    没有足够的内存可用于执行更新过程

请参见 _doserrno、errno、_sys_errlist 和_sys_nerr 有关这些内容的更多信息以及其他,返回代码。

备注

这些功能中的每个创建并执行更新过程,通过一组指向命令行参数和一组指向环境设置。 这些函数使用 PATH 环境变量查找文件执行。

这些功能验证其参数。 如果 cmdname 或 argv 是 null 指针,或者,如果 argv 点 null 指针或 argv[0] 是空字符串,无效参数调用处理程序,如 参数验证 所述。 如果执行允许继续,对 EINVAL的这些功能集 errno,并且返回 -1。 不更新过程为。

要求

实例

必需的标头

_spawnvpe

<stdio.h> 或 <process.h>

_wspawnvpe

<stdio.h> 或 <wchar.h>

有关其他的兼容性信息,请参见中介绍的 兼容性

示例

在参见 _spawn,_wspawn 功能的示例。

.NET Framework 等效项

请参见

参考

abort

atexit

_exec, _wexec功能

exit, _exit

_flushall

_getmbcp

_onexit, _onexit_m

_setmbcp

system, _wsystem