_spawnlpe、_wspawnlpe_spawnlpe, _wspawnlpe

创建并执行更新过程。Creates and executes a new process.

Important

此 API 不能用于在 Windows 运行时中执行的应用程序。This API cannot be used in applications that execute in the Windows Runtime. 有关详细信息,请参阅通用 Windows 平台应用中不支持的 CRT 函数For more information, see CRT functions not supported in Universal Windows Platform apps.

语法Syntax

intptr_t _spawnlpe(  
   int mode,  
   const char *cmdname,  
   const char *arg0,  
   const char *arg1,  
   ... const char *argn,  
   NULL,  
   const char *const *envp   
);  
intptr_t _wspawnlpe(  
   int mode,  
   const wchar_t *cmdname,  
   const wchar_t *arg0,  
   const wchar_t *arg1,  
   ... const wchar_t *argn,  
   NULL,  
   const wchar_t *const *envp   
);  

参数Parameters

mode
调用进程的执行模式。Execution mode for the calling process.

cmdname
要执行的文件的路径。Path of the file to be executed.

arg0, arg1, ... argn
指向参数的指针的列表。List of pointers to arguments. arg0 参数通常是指向 cmdname 的指针。The arg0 argument is typically a pointer to cmdname. 参数 arg1argn 是指向构成新参数列表的字符字符串的指针。The arguments arg1 through argn are pointers to the character strings that form the new argument list. argn之后,必须是一个 NULL 指针,用以标记参数列表的末尾。Following argn, there must be a NULL pointer to mark the end of the argument list.

envp
指向环境设置的指针的数组。Array of pointers to environment settings.

返回值Return Value

同步 _spawnlpe_wspawnlpe(为 _P_WAIT 指定的 mode)中的返回值是新进程的退出状态。The return value from a synchronous _spawnlpe or _wspawnlpe (_P_WAIT specified for mode) is the exit status of the new process. 异步 _spawnlpe_wspawnlpe(为 _P_NOWAIT 指定的 _P_NOWAITOmode)的返回值是进程句柄。The return value from an asynchronous _spawnlpe or _wspawnlpe (_P_NOWAIT or _P_NOWAITO specified for mode) is the process handle. 如果进程正常终止,则退出状态为 0。The exit status is 0 if the process terminated normally. 如果生成进程专门使用非零参数调用 exit 例程,则可以将退出状态设置为一个非零值。You can set the exit status to a nonzero value if the spawned process specifically uses a nonzero argument to call the exit routine. 如果更新过程未显式设置正退出状态,则正退出状态指示因中止或中断而造成的异常退出。If the new process did not explicitly set a positive exit status, a positive exit status indicates an abnormal exit caused by an abort or an interrupt. 返回值-1 指示的错误 (不启动新过程)。A return value of -1 indicates an error (the new process is not started). 在这种情况下, errno 设置为下列值之一。In this case, errno is set to one of the following values.

E2BIG
参数列表超过 1024 个字节。Argument list exceeds 1024 bytes.

EINVAL
mode 参数无效。mode argument is invalid.

ENOENT
未找到文件或路径。File or path is not found.

ENOEXEC
指定的文件不是可执行文件,或者具有无效的可执行文件格式。Specified file is not executable or has an invalid executable-file format.

ENOMEM
没有足够的内存可用于执行新进程。Not enough memory is available to execute the new process.

有关这些代码及其他返回代码的详细信息,请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerrFor more information about these and other return codes, see errno, _doserrno, _sys_errlist, and _sys_nerr.

备注Remarks

其中每个函数都创建并执行一个新进程,将每个命令行自变量作为单独的参数进行传递,并将一个数组指针传递给环境设置。Each of these functions creates and executes a new process, passes each command-line argument as a separate parameter, and passes an array of pointers to environment settings. 这些函数使用 PATH 环境变量查找要执行的文件。These functions use the PATH environment variable to find the file to execute.

这些函数验证其参数。These functions validate their parameters. 如果 cmdnamearg0 是空字符串或 null 指针,则调用的参数处理程序无效,如 Parameter ValidationIf either cmdname or arg0 is an empty string or a null pointer, the invalid parameter handler is invoked, as described in Parameter Validation. 如果允许执行继续,则这些功能将 errno 设置为 EINVAL,并返回 -1。If execution is allowed to continue, these functions set errno to EINVAL, and return -1. 不生成任何新进程。No new process is spawned.

惠?Requirements

例程所返回的值Routine 必需的标头Required header
_spawnlpe <process.h><process.h>
_wspawnlpe <stdio.h> 或 <wchar.h><stdio.h> or <wchar.h>

有关更多兼容性信息,请参阅 兼容性For more compatibility information, see Compatibility.

示例Example

在参见 _spawn、_wspawn 函数中的示例。See the example in _spawn, _wspawn Functions.

请参阅See Also

进程和环境控制 Process and Environment Control
_spawn、_wspawn 函数 _spawn, _wspawn Functions
abort abort
atexit atexit
_exec、_wexec 函数 _exec, _wexec Functions
exit、_Exit、_exit exit, _Exit, _exit
_flushall _flushall
_getmbcp _getmbcp
_onexit、_onexit_m _onexit, _onexit_m
_setmbcp _setmbcp
system、_wsystemsystem, _wsystem