_execvpe _wexecvpe

Č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 _execvpe( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecvpe( 
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

Parametry

cmdname
Cesta k souboru, který chcete spustit.
argv
Pole 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í.
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 i jiných návratové kódy, viz Kód chyby, _doserrno, _sys_errlist a _sys_nerr.

Poznámky

Každá z těchto funkcí načte a spustí nový proces a předá matice ukazatelů argumenty příkazového řádku a pole ukazatelů pro nastavení prostředí.Pomocí těchto funkcí PATH proměnné prostředí, vyhledejte soubor, který chcete spustit.

_execvpe Funkce ověření jejich parametrů.Pokud cmdname je ukazatel s hodnotou null, nebo pokud argv je nulový ukazatel, ukazatel na prázdné pole nebo odkaz na matici, která obsahuje prázdný řetězec jako první argument, 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ý proces je spuštěn.