_execlpe, _wexeclpe

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 _execlpe( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexeclpe( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *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 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.
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 ani ś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.

Aby uzyskać więcej informacji na temat tych i innych kodów zwrotu, zobacz _doserrno, errno, _sys_errlist, and _sys_nerr.

Uwagi

Każda z tych funkcji ładuje i uruchamia nowy proces, przekazując każdy argument wiersza polecenia jako oddzielny parametr i przekazując także tablicę wskaźników do ustawienia środowiska.Te funkcje używa PATH zmiennej środowiskowej, aby znaleźć plik do wykonania.

Funkcje _execlpe sprawdzają poprawność swoich parametrów.Jeśli cmdname lub arg0 są pustymi wskaźnikami lub pustym ciągiem, funkcje te wywołują procedurę obsługi nieprawidłowego parametru, zgodnie z opisem w temacie 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.