Поделиться через


_execlpe, _wexeclpe

Загружает и выполняет новые дочерние процессы.

Важно!

Этот API невозможно использовать в приложениях, запускаемых в среде выполнения Windows.Дополнительные сведения см. в статье Функции CRT, которые не поддерживаются с ключом /ZW.

intptr_t _execlpe( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexeclpe( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *const *envp 
);

Параметры

  • cmdname
    Путь к файлу для запуска.

  • arg0, ...argn
    Список указателей на параметры.

  • envp
    Массив указателей на параметры среды.

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

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

Значение errno

Описание

E2BIG

Требуемое место для аргументов и параметров среды превышает 32 КБ.

EACCES

Указанный файл имеет блокировку или нарушение совместного использования.

EINVAL

Неверный параметр

EMFILE

Слишком много открытых файлов (указанный файл должен быть открыт чтобы определить, является ли он исполняемым).

ENOENT

Не найден файл или путь.

ENOEXEC

Указанный файл не является исполняемым или имеет недопустимый формат исполняемого файла.

ENOMEM

Недостаточно памяти для выполнения нового процесса; доступная память была повреждена;существует недопустимый блок, показывающий, что вызывающий процесс не был правильно размещен.

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

Заметки

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

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

Требования

Функция

Обязательный заголовок

Необязательный заголовок

_execlpe

<process.h>

<errno.h>

_wexeclpe

<process.h> или <wchar.h>

<errno.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

См. пример в Функции _exec, _wexec.

Эквивалент в .NET Framework

См. также

Ссылки

Управление процессами и средой

Функции _exec, _wexec

abort

atexit

exit, _exit

_onexit, _onexit_m

Функции _spawn, _wspawn

system, _wsystem