_execvpe, _wexecvpe

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 _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 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.
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 i innych kody powrotne, zobacz errno, _doserrno, _sys_errlist i _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 ustawień środowiska.Te funkcje za pomocą PATH zmiennej środowiskowej, aby znaleźć plik, aby wykonać.

_execvpe Funkcje sprawdzania poprawności ich parametrów.Jeśli cmdname jest pusty wskaźnik, lub jeśli argv jest pusty wskaźnik, wskaźnik do pustą tablicę albo wskaźnik do tablicy, która zawiera pusty ciąg jako pierwszy argument, tych funkcji WYWOŁAJ obsługi przez 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 proces nie jest uruchomiona.