_execl, _wexecl

Artykuł
03/26/2013

Ładuje i uruchamia nowe procesy potomne.

Ważne
Ten interfejs API nie można używać w aplikacji, których wykonywanie w czasie wykonywania systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsł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 ma być wykonane.
arg0, ...argn
Lista wskaźników do parametrów.

Wartość zwracana

W przypadku powodzenia tych funkcji bez zwracania się do procesu wywołującego.Zwracana wartość wynosząca –1 wskazuje błąd, w którym to przypadku errno jest ustawiona w zmiennej globalnej.

wartość errno	Opis
E2BIG	Miejsce wymagane dla argumentów i ustawienia ś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ł wskaźnik zerowy lub pusty ciąg).
EMFILE	Za dużo plików otwartych (do ustalenia, czy jest wykonywalny musi można otworzyć określonego pliku).
ENOENT	Nie znaleziono pliku lub ścieżki.
ENOEXEC	Określony plik nie jest wykonywalny lub ma nieprawidłowy format plików wykonywalnych.
ENOMEM	Za mało pamięci jest uruchamia nowy proces; dostępna pamięć jest uszkodzona; lub istnieje nieprawidłowy blok, wskazując, że proces wywołujący nie został poprawnie przydzielony.

Uwagi

Każda z tych funkcji ładuje i uruchamia nowy proces, przekazując każdego argumentu wiersza polecenia jako osobny parametr.Pierwszy argument jest polecenie lub nazwa pliku wykonywalnego, a drugi argument powinien być taki sam, jak pierwszy.Staje się argv[0] w procesie wykonane.Trzeci argument jest pierwszy argument, argv[1], z wykonywanego procesu.

_execl Funkcje sprawdzania poprawności ich parametrów.Jeśli każda cmdname lub arg0 jest wskaźnik zerowy lub pusty ciąg, funkcje te wywołuje procedurę obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru Jeśli wykonanie może kontynuować, ustaw te funkcje errno do EINVAL i zwraca –1.Żaden nowy proces jest wykonywany.