_execve, _wexecve

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 _execve( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecve( 
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

Parametry

cmdname
Ścieżka pliku do wykonania.
argv
Tablica 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 tablicę wskaźników do argumentów wiersza polecenia oraz tablicę wskaźników do ustawienia środowiska.

_execve i _wexecve sprawdzają poprawność swoich parametrów.Jeśli cmdname jest wskaźnikiem wartości null lub jeżeli argv jest wskaźnikiem wartości null, wskaźnikiem do pustej tablicy, lub jeśli tablica zawiera pusty ciąg jako pierwszy argument, te funkcje wywołują procedurę obsługi nieprawidłowego parametru, 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 proces nie jest uruchamiany.