_spawnv、_wspawnv

發行項
06/09/2015

建立和執行新處理序。

重要

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

intptr_t _spawnv(
   int mode,
   const char *cmdname,
   const char *const *argv 
);
intptr_t _wspawnv(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *const *argv 
);

參數

mode
呼叫處理序的執行模式。
cmdname
待執行檔案的路徑。
argv
引數指標的陣列。引數 argv[0] 通常是指向路由模式中的路徑或受保護模式中的程序名稱之指標，而 argv[1] 至 argv[n] 是指向形成新的引數清單的字串。引數 argv[n +1] 必須是 NULL 指標，以標記引數清單的結尾。

傳回值

同步處理 _spawnv 或 _wspawnv (若 mode 則為 _P_WAIT) 的傳回值是新處理序的結束狀態。非同步 _spawnv 或 _wspawnv 的傳回值 (若 mode 則為 _P_NOWAITO 或_P_NOWAIT ) 為流程控制代碼。如果處理序正常終止，結束狀態為 0。如果繁衍的處理序會用非零的引數明確呼叫 exit 常式，您就可以將結束狀態設為非零值。如果新處理序未明確設定確定的結束狀態，所謂確定的結束狀態表示因中止或中斷而不正常結束。傳回值為 –1 表示錯誤 (新處理序未啟動)。在這種情況下，errno 會設為下列其中一個值。

E2BIG
引數清單超過 1024 個位元組。
EINVAL
mode 引數無效。
ENOENT
找不到檔案或路徑。
ENOEXEC
指定的檔案無法執行或可執行檔格式無效。
ENOMEM
可用記憶體不足，無法執行新處理序。

如需更多關於這些和其他回傳碼的資訊，請參閱 _doserrno 、 errno 、 _sys_errlist 、和 _sys_nerr (_doserrno, errno, _sys_errlist, and _sys_nerr) 。

備註

這些函式建立並執行新的處理序，傳遞一個指標陣列至命令列引數。

這些函式會驗證它們的參數。如果 cmdname 或 argv 其中之一為 null 指標，或者如果 argv 指向 null，或者如果 argv[0] 為空字串，則會叫用無效參數處理常式，如參數驗證中所述。如果允許繼續執行，這些函式會將 errno 設為 EINVAL，並傳回 -1。未繁衍任何新處理序。