_execlpe, _wexeclpe

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 _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 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	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.
EMFILE	Za dużo plików otwartych (do ustalenia, czy jest wykonywalny musi można otworzyć określonego pliku).
ENOENT	Plik lub nie można odnaleźć ś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.

Aby uzyskać więcej informacji na temat tych i innych kody powrotne, zobacz _doserrno, errno, _sys_errlist i _sys_nerr.

Uwagi

Każda z tych funkcji ładuje i uruchamia nowy proces, przekazując każdego argumentu wiersza polecenia jako osobny parametr a także przekazanie tablicy wskaźników do ustawień środowiska.Te funkcje za pomocą PATH zmiennej środowiskowej, aby znaleźć plik, aby wykonać.

_execlpe Funkcje sprawdzania poprawności ich parametrów.Jeśli każda cmdname lub arg0 jest wartość null wskaźniki 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.