_execle, _wexecle

Artykuł
06/09/2015

Ładuje i uruchamia procesy podrzędne.

Ważne
Ten interfejs API nie może być stosowany w aplikacjach, które są wykonywane w Środowisko wykonawcze systemu Windows .Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /ZW.

intptr_t _execle( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexecle( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const char *const *envp 
);

Parametry

cmdname
Ścieżka pliku do wykonania.
arg0, ...argn
Lista wskaźników do parametrów.
envp
Tablica ustawienia środowiska.

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.

Wartość wyliczenia errno	Opis
E2BIG	Miejsce, które jest wymagane do ustawienia środowiska i argumenty przekracza 32 KB.
EACCES	Określony plik ma naruszenie zasad współużytkowania lub blokowania.
EINVAL	Nieprawidłowy parametr.
EMFILE	Zbyt wiele plików jest już otwartych. (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 pliku wykonywalnego.
ENOMEM	Za mało pamięci jest dostępnych do wykonywania nowego procesu; dostępna pamięć jest uszkodzona; lub istnieje nieprawidłowy blok, który wskazuje, że proces wywołujący nie został poprawnie przydzielony.

Aby uzyskać więcej informacji dotyczących tych kody zwrotne, zobacz _doserrno, numer błędu, _sys_errlist i _sys_nerr.

Uwagi

Każda z tych funkcji ładuje i uruchamia nowy proces i przekazuje każdego argumentu wiersza polecenia jako oddzielnego parametru i przekazuje tablica ustawienia środowiska.

Funkcje _execle sprawdzają poprawność swoich parametrów.Jeśli cmdname lub arg0 jest wskaźnik zerowy lub pusty ciąg, tych funkcji Wywołaj obsługę nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, te funkcje ustawiają errno na EINVAL i zwracają wartość -1.Żaden nowy proces nie jest uruchamiany.