_execle _wexecle

Č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 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 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	Prostor, který má požadované 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	Je otevřeno příliš mnoho souborů.(Chcete-li zjistit, zda je spustitelný soubor musí otevřít zadaný 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 neplatný blok existuje, což znamená, že volající proces nebyl správně přidělen.

Další informace o těchto 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 a předává každý argument příkazového řádku jako samostatné parametr a předá matice ukazatelů nastavení prostředí.

_execle Funkce ověření jejich parametrů.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í 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.