_execl, _wexecl

Artykuł
06/09/2015

Ładuje i uruchamia procesy podrzędne.

Ważne
Tego API nie można używać w aplikacjach korzystających ze środowiska wykonawczego Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /ZW.

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 zwracają procesu wywołującego.Zwracana wartość -1 wskazuje błąd, w którym to przypadku errno zmienna globalna jest ustawiona.

errno value	Opis
E2BIG	Miejsce wymagane dla argumentów i ustawień środowiska przekracza 32 KB.
EACCES	Określony plik ma naruszenie zasad współużytkowania lub blokowania.
EINVAL	Nieprawidłowy parametr (jeden lub więcej parametrów było wskaźnikiem zerowym lub pustym ciągiem).
EMFILE	Za dużo plików otwartych (do których musi zostać otwarty określony plik w celu określenia czy jest wykonywalny).
ENOENT	Nie znaleziono pliku lub ścieżki.
ENOEXEC	Określony plik nie jest wykonywalny lub ma nieprawidłowy format pliku wykonywalnego.
ENOMEM	Za mało pamięci jest dostępne do wykonania nowego procesu; dostępna pamięć jest uszkodzona; lub istnieje nieprawidłowy blok, wskazujący, że proces wywołujący nie został poprawnie przydzielony.

Uwagi

Każda z tych funkcji ładuje i uruchamia nowy proces, przekazując każdy argument wiersza polecenia jako oddzielny parametr.Pierwszy argument jest poleceniem lub nazwą pliku wykonywalnego, a drugi argument powinien być taki sam jak pierwszy.Staje się argv[0] w procesie wykonanym.Trzeci argument jest pierwszym argumentem, argv[1], proces jest wykonywany.

Funkcje _execl sprawdzają poprawność swoich parametrów.Jeśli cmdname lub arg0 jest wskaźnikiem typu null lub pustym ciągiem, te funkcje wywołują procedurę obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru; jeśli wykonanie może być kontynuowane, funkcje te ustawiają errno jako EINVAL i zwracają wartość -1.Żaden nowy proces nie jest wykonywany.