_execve, _wexecve

Článek
06/09/2015

Načte a spustí nový podřízený proces.

Důležité
Toto API nelze použít v aplikacích, které jsou spuštěny v modulu Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

intptr_t _execve( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecve( 
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

Parametry

cmdname
Cesta souboru, který má být spuštěn.
argv
Pole ukazatelů na parametry.
envp
Pole ukazatelů na nastavení prostředí.

Vrácená hodnota

V případě úspěchu se tato funkce nevrací do volajícího procesu.Návratová hodnota –1 označuje chybu a v takovém případě je nastavena globální proměnná errno.

Hodnota errno	Description
E2BIG	Místo požadované pro argumenty a nastavení prostředí je větší než 32 KB.
EACCES	Zadaný soubor má narušení uzamčení nebo sdílení.
EINVAL	Neplatný parametr.
EMFILE	Příliš mnoho otevřených souborů (zadaný soubor musí být otevřen pro určení, zda je spustitelný).
ENOENT	Nebyl nalezen soubor nebo cesta.
ENOEXEC	Zadaný soubor není spustitelný soubor nebo má neplatný formát spustitelného souboru.
ENOMEM	Není dostatek paměti k dispozici pro spuštění nového procesu; dostupná paměť byla poškozena; nebo existuje neplatný blok, což znamená, že volající proces nebyl správně přidělen.

Další informace o těchto a dalších návratových kódech naleznete v části _doserrno, errno, _sys_errlist, and _sys_nerr.

Poznámky

Každá z těchto funkcí načte a spustí nový proces, předá pole ukazatelů do argumentů příkazového řádku a pole ukazatelů do nastavení prostředí.

_execve a _wexecve ověří své parametry.Pokud cmdname je ukazatel s hodnotou null, nebo pokud argv je nulový ukazatel, ukazatel na prázdné pole, nebo pokud pole obsahuje prázdný řetězec jako první argument, tyto funkce Ověření parametru vyvolají obslužnou rutinu neplatného parametru, jak je popsáno v .Pokud smí provádění pokračovat, tyto funkce nastaví errno na EINVAL a vrátí -1.Není spuštěn žádný proces.