_execlpe _wexeclpe

Článek
03/26/2013

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

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v systému 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 k souboru, který chcete spustit.
arg0, ...argn
Chcete-li zobrazit seznam ukazatelů pro parametry.
envp
Pole ukazatelů pro nastavení prostředí.

Vrácená hodnota

V případě úspěchu tato funkce nevkládejte do volající proces.Vrácená hodnota –1 označuje chybu, v kterémžto případě errno nastavit globální proměnné.

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

Další informace o těchto i jiných návratové kódy, viz _doserrno, kód chyby, _sys_errlist a _sys_nerr.

Poznámky

Každá z těchto funkcí načte a spustí nový proces, předá každý argument příkazového řádku jako samostatné parametr a také k nastavení prostředí předávání pole ukazatelů.Pomocí těchto funkcí PATH proměnné prostředí, vyhledejte soubor, který chcete spustit.

_execlpe Funkce ověření jejich parametrů.Pokud cmdname nebo arg0 je null ukazatele nebo prázdný řetězec, tyto funkce vyvolat obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, tyto funkce set errno na EINVAL a vrátí hodnotu -1.Žádný nový proces je spuštěn.