_execle, _wexecle

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 Środowisko wykonawcze systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsł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 wskaźników do ustawień środowiska.

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.

errnowartość	Opis
E2BIG	Miejsca, co jest 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.
EMFILE	Zbyt wiele plików są otwarte.(Aby ustalić, 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, która wskazuje, że proces wywołujący nie został poprawnie przydzielony.

Aby uzyskać więcej informacji na temat tych kody powrotne, zobacz _doserrno, errno, _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 szereg wskaźników do ustawień środowiska.

_execle Funkcje sprawdzania poprawności ich parametrów.Jeśli 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 uruchamiany.