共用方式為


_execle、_wexecle

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

重要

這個應用程式開發介面不能用於 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 是 null 指標或空字串,這些函式會觸發無效參數處理常式,如 參數驗證 裡所述。 如果允許繼續執行,這些函式會將 errno 設為 EINVAL,並傳回 -1。 不會啟動新的處理程序。

需求

功能

必要的標頭

選擇性標頭

_execle

<process.h>

<errno.h>

_wexecle

<process.h> 或 <wchar.h>

<errno.h>

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

範例

請參閱_exec、_wexec 函式中的範例。

.NET Framework 對等用法

請參閱

參考

流程控制和環境控制

_exec、_wexec 函式

abort

atexit

exit、_exit

_onexit、_onexit_m

_spawn、_wspawn 函式

system、_wsystem