_execve, _wexecve

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 _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 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, przekazanie tablicy wskaźników do argumentów wiersza polecenia oraz szereg wskaźników do ustawień środowiska.

_execvei _wexecve sprawdzania poprawności ich parametrów.Jeśli cmdname jest pusty wskaźnik, lub jeśli argv jest pusty wskaźnik, wskaźnik do tablicy pusty lub jeśli tablica zawiera pusty ciąg jako pierwszy argument, 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 proces nie jest uruchomiona.