Sdílet prostřednictvím

_execvpe, _wexecvpe

  • Článek

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

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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ý se má provést.

argv
Pole ukazatelů na parametry

envp
Pole ukazatelů na nastavení prostředí

Vrácená hodnota

V případě úspěchu se tyto funkce nevrátí do volajícího procesu. Vrácená hodnota -1 označuje chybu, v takovém případě errno je nastavena globální proměnná.

errno hodnota Popis
E2BIG Mezera požadovaná pro argumenty a nastavení prostředí překračuje 32 kB.
EACCES Zadaný soubor má narušení uzamčení nebo sdílení.
EMFILE Je otevřeno příliš mnoho souborů. (Zadaný soubor musí být otevřen, aby bylo možné určit, jestli je spustitelný.)
ENOENT Soubor nebo cesta se nenašly.
ENOEXEC Zadaný soubor není spustitelný nebo má neplatný formát spustitelného souboru.
ENOMEM K provedení nového procesu není k dispozici dostatek paměti; dostupná paměť byla poškozena; nebo existuje neplatný blok, který značí, ž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 tématu , , , a_sys_nerr . _sys_errlist_doserrnoerrno

Poznámky

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

Funkce _execvpe ověřují své parametry. Tyto funkce volají neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru, pokud:

  • cmdname je ukazatel null,
  • argv je buď ukazatel null, nebo ukazatel na prázdné pole,
  • Pole obsahuje prázdný řetězec jako první argument.

Pokud obslužná rutina může pokračovat spuštěním, tyto funkce jsou nastaveny errno na EINVALhodnotu a vrátí hodnotu -1. Není spuštěn žádný proces.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Function Požadovaný hlavičkový soubor Volitelné záhlaví
_execvpe <process.h> <errno.h>
_wexecvpe <process.h> nebo <wchar.h> <errno.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

Podívejte se na příklad ve _execfunkcích . _wexec

Viz také

Řízení procesů a prostředí
_exec, _wexec funkce
abort
atexit
exit, , _Exit_exit
_onexit, _onexit_m
_spawn, _wspawn funkce
system, _wsystem