_spawnlpe, _wspawnlpe

Článek
06/09/2015

Vytvoří a spustí nový proces.

Důležité
Toto rozhraní 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 _spawnlpe(
   int mode,
   const char *cmdname,
   const char *arg0,
   const char *arg1,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wspawnlpe(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *arg0,
   const wchar_t *arg1,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *const *envp 
);

Parametry

mode
Spuštění režimu pro volající proces.
cmdname
Cesta k souboru, který má být proveden.
arg0, arg1, ... argn
Chcete-li zobrazit seznam ukazatelů pro argumenty.arg0 Argument je obvykle ukazatel na cmdname.Argumenty arg1 přes argn jsou ukazatele do řetězce znaků, které tvoří nový seznam argumentů.Po argn, musí být NULL ukazatel na konec seznamu argumentů.
envp
Pole ukazatelů pro nastavení prostředí.

Vrácená hodnota

Hodnota vrácená synchronního _spawnlpe nebo _wspawnlpe (_P_WAIT určený pro mode) je stav ukončení nový proces.Hodnota vrácená asynchronní _spawnlpe nebo _wspawnlpe (_P_NOWAIT nebo _P_NOWAITO určený pro mode) je popisovač procesu.Stav ukončení je 0, je-li proces ukončen normálně.Můžete nastavit stav ukončení nenulovou hodnotu, pokud proces konkrétně používá nenulovou argument volání exit rutina.Je-li nový proces stav pozitivní ukončit explicitně nenastavili, označuje stav pozitivní konec abnormálního ukončení, způsobené přerušením nebo přerušení.Vrácená hodnota –1 označuje chybu (není spuštěn nový proces).V tomto případě errno je nastavena na jednu z následujících hodnot.

E2BIG
Seznam argumentů přesahuje 1024 bajtů.
EINVAL
modeargument není platný.
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 k dispozici spustit nový proces.

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

Poznámky

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

Tyto funkce ověření jejich parametrů.Pokud cmdname nebo arg0 je prázdný nebo nulový ukazatel, obslužná rutina neplatný parametr je vyvolán, jak je popsáno v Ověření parametru.Pokud je povoleno zpracování, chcete-li pokračovat, tyto funkce set errno na EINVALa vrátí -1.Je vytvořen žádný nový proces.