_execvpe, _wexecvpe

Článek
06/09/2015

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

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 _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 souboru, který má být spuštěn.
argv
Pole 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í.
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 tomto a dalších návratových kódech naleznete v tématu errno, _doserrno, _sys_errlist, and _sys_nerr.

Poznámky

Každá z těchto funkcí načte a spustí nový proces a předává matici ukazatelů argumenty příkazového řádku a pole ukazatelů pro nastavení prostředí.Tyto funkce používají proměnnou prostředí PATH pro vyhledání soubor, který spustí.

Funkce _execvpe ověřují své parametry.Pokud cmdname je ukazatel s hodnotou null, nebo pokud argv je nulový ukazatel, prázdné pole ukazatel nebo ukazatele 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í parametru.Pokud smí provádění pokračovat, tyto funkce nastaví errno na EINVAL a vrátí -1.Není spuštěn žádný proces.