_execvpe _wexecvpe

發行項
03/26/2013

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

重要

這個應用程式開發介面無法用來在 Windows 執行階段中執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

intptr_t _execvpe( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecvpe( 
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

參數

cmdname
欲執行的檔案路徑。
argv
陣列參數的指標。
envp
指向環境設定的指標的陣列。

傳回值

如果成功的話，這些函式將不會回傳給呼叫處理程序。回傳值 -1 表示發生錯誤，此時 errno 將會被設置。

errno 值	描述
E2BIG	如需引數和環境設定所需的空間超過 32 KB。
EACCES	指定的檔案發生鎖定或分享衝突。
EMFILE	許多檔案已經開啟。 (必須開啟指定的文件來判斷它是否可執行檔)。
ENOENT	檔案或路徑找不到。
ENOEXEC	指定的檔案無法執行或可執行檔格式無效。
ENOMEM	沒有足夠的記憶體可用執行流程;可用的記憶體損毀;或不正確的區塊存在，表示沒有正確配置呼叫程序。

如需這些與任何其他傳回碼的詳細資訊，請參閱 errno、 _doserrno、 _sys_errlist 和 _sys_nerr。

備註

這些函式都會載入並執行處理序，並透過指標陣列命令列引數和指標陣列環境設定。這些函式使用 PATH 環境變數來尋找檔案以執行。

_execvpe 函式會驗證它們的參數。如果 cmdname 為 null 指標，則為，如果 argv 為 null 指標、空陣列或指標包含空字串做為第一個引數的陣列，這些函式叫用無效的參數處理常式，如參數驗證中所述。如果允許繼續執行，這些函式將 EINVAL 設置為 errno 並回傳 -1 。處理序尚未啟動。