_execl, _wexecl

Č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 _execl( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL 
);
intptr_t _wexecl(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL 
);

Parametry

cmdname
Cesta souboru, který má být spuštěn.
arg0, ...argn
Seznam ukazatelů na parametry.

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 (jeden nebo více parametrů byl ukazatel s hodnotou null nebo prázdný řetězec).
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.

Poznámky

Každá z těchto funkcí načte a spustí nový proces a předá každý argument příkazového řádku jako samostatný parametr.První argument je příkaz nebo název spustitelného souboru a druhý argument by měl být stejný jako první.Stává se argv[0] v provedeném procesu.Třetí argument je první argument argv[1] procesu, který je prováděn.

Funkce _execl ověřují své parametry.Pokud cmdname nebo arg0 je ukazatel s hodnotou null nebo prázdný řetězec, tyto funkce vyvolají obslužnou rutinu neplatného parametru, jak je popsáno v Ověření parametru. Pokud je povoleno pokračování provádění, tyto funkce nastaví errno na EINVAL a vrátí -1.Není proveden žádný nový proces.