_execlpe, _wexeclpe

Č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 _execlpe( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexeclpe( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *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	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řičemž předá každý argument příkazového řádku jako samostatný parametr a také předá pole ukazatelů do nastavení prostředí.Tyto funkce používají proměnnou prostředí PATH pro vyhledání soubor, který spustí.

Funkce _execlpe ověřují své parametry.Pokud je cmdname nebo arg0 ukazatel s hodnotou null nebo prázdný řetězec, tyto funkce vyvolají neplatnou obslužnou rutinu parametru, jak je popsáno v tématu 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.