_execle, _wexecle

Č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 prostředí Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

intptr_t _execle( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexecle( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const char *const *envp 
);

Parametry

cmdname
Cesta souboru, který má být spuštěn.
arg0, ...argn
Seznam 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	Je otevřeno příliš mnoho souborů. (Chcete-li zjistit, zda je spustitelný soubor musí otevřít zadaný soubor.)
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 návratových kódů naleznete v tématu _doserrno, kód chyby, _sys_errlist a _sys_nerr.

Poznámky

Každá z těchto funkcí načte a spustí nový proces a každý argument příkazového řádku předá jako parametr samostatné a předává matici ukazatele nastavení prostředí.

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