_execvpe, _wexecvpe

Статья
06/09/2015

Загружает и запускает новый дочерний процесс.

Важно!

Этот API не может использоваться в приложениях, выполняемых в Среда выполнения Windows.Дополнительные сведения см. в статье Функции CRT, которые не поддерживаются с ключом /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 
);

Параметры

cmdname
Путь к файлу для запуска.
argv
Массив указателей на параметры.
envp
Массив указателей на параметры среды.

Возвращаемое значение

Если успешно, эти функции не возвращают вызывающему процессу. Возвращаемое значение –1 означает ошибку, в соответствии с которой устанавливается глобальная переменная errno.

Значение errno	Описание
E2BIG	Размер пространства, требуемого для аргументов и параметров среды превышает 32 КБ.
EACCES	Указанный файл имеет блокировку или нарушение совместного использования.
EMFILE	Открыто слишком много файлов. (Необходимо открыть указанный файл, чтобы определить, является ли он исполняемым).
ENOENT	Файл или путь не найден.
ENOEXEC	Указанный файл не является исполняемым или имеет недопустимый формат исполняемого файла.
ENOMEM	Недостаточно памяти для выполнения нового процесса; доступная память была повреждена; существует недопустимый блок, показывающий, что вызывающий процесс не был правильно размещен.

Дополнительные сведения об этих и других кодах возврата см. в разделе errno, _doserrno, _sys_errlist, and _sys_nerr.

Заметки

Каждая из этих функций загружает и выполняет новый процесс, передает ему массив указателей на аргументы командной строки и массив указателей на параметры среды. Эти функции используют переменную среды PATH чтобы найти файл для выполнения.

Функции _execvpe проверяют их параметры. Если cmdname указатель на null, или если argv указатель на null или указатель на пустой массив, или если указатель на массив содержит пустую строку в качестве первого аргумента, то эти функции вызывают обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, эти функции устанавливают для errno значение EINVAL и возвращают -1. Ни один процесс не запущен.