_execl, _wexecl

Načte a spustí nové podřízené procesy.

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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 k souboru, který se má spustit.

arg0, ... argN
Seznam ukazatelů na parametry

Vrácená hodnota

V případě úspěchu se tyto funkce nevrátí do volajícího procesu. Vrácená hodnota -1 označuje chybu, v takovém případě errno je nastavena globální proměnná.

errno hodnota	Popis
E2BIG	Požadované místo pro argumenty a nastavení prostředí překračuje 32 kB.
EACCES	Zadaný soubor má narušení uzamčení nebo sdílení.
EINVAL	Neplatný parametr (jeden nebo více parametrů byl ukazatel null nebo prázdný řetězec).
EMFILE	Příliš mnoho otevřených souborů (zadaný soubor musí být otevřen, aby bylo možné určit, jestli je spustitelný).
ENOENT	Soubor nebo cesta se nenašly.
ENOEXEC	Zadaný soubor není spustitelný nebo má neplatný formát spustitelného souboru.
ENOMEM	K provedení nového procesu není k dispozici dostatek paměti; dostupná paměť byla poškozena; nebo existuje neplatný blok označující, ž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ím argumentem je název příkazu nebo spustitelného souboru a druhý argument by měl být stejný jako první. Stane se argv[0] v procesu provádění. Třetím argumentem je první argument, argv[1]tedy proces, který se spouští.

Funkce _execl ověřují své parametry. Pokud je buď cmdname ukazatel null nebo arg0 prázdný řetězec, tyto funkce vyvolat neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru Pokud provádění je povoleno pokračovat, tyto funkce jsou nastaveny errno na EINVAL a vrátit -1. Nespustí se žádný nový proces.

Požadavky

Function	Požadovaný hlavičkový soubor	Volitelné záhlaví
_execl	<process.h>	<errno.h>
_wexecl	<process.h> nebo <wchar.h>	<errno.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

Podívejte se na příklad ve _execfunkcích . _wexec

Viz také

Řízení procesů a prostředí
_exec, _wexec funkce
abort
atexit
exit, , _Exit_exit
_onexit, _onexit_m
_spawn, _wspawn funkce
system, _wsystem