_execl, _wexecl

Ładuje i wykonuje nowe procesy podrzędne.

Ważne

Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

intptr_t _execl(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL
);
intptr_t _wexecl(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL
);

Parametry

cmdname
Ścieżka pliku do wykonania.

arg0, ... argN
Lista wskaźników do parametrów.

Wartość zwracana

W przypadku powodzenia te funkcje nie wracają do procesu wywołującego. Wartość zwracana -1 wskazuje błąd, w którym przypadku zmienna errno globalna jest ustawiona.

errno wartość	opis
E2BIG	Miejsce wymagane dla argumentów i ustawień środowiska przekracza 32 KB.
EACCES	Określony plik ma naruszenie blokady lub udostępniania.
EINVAL	Nieprawidłowy parametr (co najmniej jeden parametr był wskaźnikiem o wartości null lub pustym ciągiem).
EMFILE	Za dużo otwartych plików (określony plik musi zostać otwarty, aby określić, czy jest to plik wykonywalny).
ENOENT	Nie można odnaleźć pliku lub ścieżki.
ENOEXEC	Określony plik nie jest wykonywalny lub ma nieprawidłowy format pliku wykonywalnego.
ENOMEM	Za mało pamięci do wykonania nowego procesu; dostępna pamięć została uszkodzona; lub istnieje nieprawidłowy blok wskazujący, że proces wywołujący nie został prawidłowo przydzielony.

Uwagi

Każda z tych funkcji ładuje i wykonuje nowy proces, przekazując każdy argument wiersza polecenia jako oddzielny parametr. Pierwszym argumentem jest nazwa polecenia lub pliku wykonywalnego, a drugi argument powinien być taki sam jak pierwszy. Staje się argv[0] on w wykonywanym procesie. Trzeci argument jest pierwszym argumentem , argv[1]wykonywanego procesu.

Funkcje _execl weryfikują swoje parametry. Jeśli element cmdname lub arg0 jest wskaźnikiem null lub pustym ciągiem, te funkcje wywołują nieprawidłową procedurę obsługi parametrów zgodnie z opisem w temacie Weryfikacja parametru Jeśli wykonanie może kontynuować, te funkcje są ustawione errno na EINVAL wartość i zwracają wartość -1. Nie jest wykonywany żaden nowy proces.

Wymagania

Function	Wymagany nagłówek	Opcjonalny nagłówek
_execl	<process.h>	<errno.h>
_wexecl	<process.h> lub <wchar.h>	<errno.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

Zobacz przykład w _exec_wexec temacie , functions.

Zobacz też

Kontrola procesu i środowiska
_exec, _wexec funkcje
abort
atexit
exit, , _Exit_exit
_onexit, _onexit_m
_spawn, _wspawn funkcje
system, _wsystem