_execvpe, _wexecvpe

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 _execvpe( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecvpe( 
   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, które jest wymagane do argumentów i ustawień środowiska przekracza 32 KB.
EACCES	Określony plik ma naruszenie zasad współużytkowania lub blokowania.
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ć informacje o tych i innych kodach powrotnych, zobacz errno, _doserrno, _sys_errlist, and _sys_nerr.

Uwagi

Każda z tych funkcji ładuje i uruchamia nowy proces i przekazuje szereg wskaźników do argumentów wiersza polecenia oraz szereg wskaźników do ustawienia środowiska.Te funkcje używa PATH zmiennej środowiskowej, aby znaleźć plik do wykonania.

Funkcje _execvpe sprawdzają poprawność swoich parametrów.Jeśli cmdname jest pusty wskaźnik, lub jeśli argv jest pusty wskaźnik, wskaźnik do pusta tablica lub wskaźnika do tablicy, która zawiera pusty ciąg jako pierwszy argument, 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 proces nie jest uruchamiany.