_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.