_execle, _wexecle

載入並執行新的子處理序。

重要

這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 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	記憶體不足，無法執行新的進程;可用的記憶體已損毀;或不正確區塊存在，表示呼叫進程未正確配置。

如需這些傳回碼的詳細資訊，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。

備註

這些函式中的每一個都會載入和執行新處理序，並將每個命令列引數做為個別參數傳遞，也會將指標的陣列傳遞至環境設定。

_execle 函式會驗證它們的參數。 如果 cmdname 或 arg0 是 Null 指標或空字串，這些函式會叫用不正確參數處理常式，如參數驗證 中所述 。 如果允許繼續執行，這些函式會將 errno 設定為 EINVAL ，並傳回 -1。 未啟動任何新的處理序。

需求

函式	必要的標頭	選擇性標頭
_execle	<process.h>	<errno.h>
_wexecle	<process.h > 或 < wchar.h>	<errno.h>

如需詳細資訊，請參閱相容性。

範例

請參閱 中的 範例， _exec_wexec 函式 。

另請參閱

進程和環境控制
_exec、 _wexec 函式
abort
atexit
exit, _Exit, _exit
_onexit, _onexit_m
_spawn、 _wspawn 函式
system, _wsystem