Udostępnij za pośrednictwem

_execvpe, _wexecvpe

  • Artykuł

Ładuje i uruchamia nowe procesy podrzędne.

Ważne

Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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 te funkcje nie wracają do procesu wywołującego. Wartość zwracana -1 wskazuje błąd, w którym przypadku zmienna errno globalna jest ustawiona.

errno wartość opis
E2BIG Miejsce wymagane dla argumentów i ustawień środowiska przekracza 32 KB.
EACCES Określony plik ma naruszenie blokady lub udostępniania.
EMFILE Zbyt wiele plików jest otwartych. (Określony plik musi zostać otwarty, aby określić, czy jest wykonywalny).
ENOENT Nie można odnaleźć pliku lub ścieżki.
ENOEXEC Określony plik nie jest wykonywalny lub ma nieprawidłowy format pliku wykonywalnego.
ENOMEM Za mało pamięci do wykonania nowego procesu; dostępna pamięć została uszkodzona; lub istnieje nieprawidłowy blok, który wskazuje, że proces wywołujący nie został poprawnie przydzielony.

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

Uwagi

Każda z tych funkcji ładuje i wykonuje nowy proces i przekazuje tablicę wskaźników do argumentów wiersza polecenia i tablicy wskaźników do ustawień środowiska. Te funkcje używają zmiennej środowiskowej PATH do znalezienia pliku do wykonania.

Funkcje _execvpe weryfikują swoje parametry. Te funkcje wywołują nieprawidłową procedurę obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów, gdy:

  • cmdname jest wskaźnikiem o wartości null,
  • argv jest wskaźnikiem o wartości null lub wskaźnikiem do pustej tablicy,
  • tablica zawiera pusty ciąg jako pierwszy argument.

Jeśli wykonanie jest dozwolone przez program obsługi, te funkcje są ustawione errno na EINVAL, i zwracają -1. Nie uruchomiono żadnego procesu.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Function Wymagany nagłówek Opcjonalny nagłówek
_execvpe <process.h> <errno.h>
_wexecvpe <process.h> lub <wchar.h> <errno.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

Zobacz przykład w _exec_wexec temacie , functions.

Zobacz też

Kontrola procesu i środowiska
_exec, _wexec funkcje
abort
atexit
exit, , _Exit_exit
_onexit, _onexit_m
_spawn, _wspawn funkcje
system, _wsystem