_execlp, _wexeclp_execlp, _wexeclp

Загружает и выполняет новые дочерние процессы.Loads and executes new child processes.

Важно!

Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows.This API cannot be used in applications that execute in the Windows Runtime. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.For more information, see CRT functions not supported in Universal Windows Platform apps.

СинтаксисSyntax

intptr_t _execlp(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL
);
intptr_t _wexeclp(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL
);

ПараметрыParameters

кмднамеcmdname
Путь к выполняемому файлу.Path of the file to execute.

arg0,... argNarg0, ... argn
Список указателей на параметры.List of pointers to parameters.

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

В случае успешного выполнения эти функции не возвращаются к вызывающему процессу.If successful, these functions do not return to the calling process. Возвращаемое значение, равное-1, указывает на ошибку . в этом случае задается глобальная переменная «пробуждение».A return value of -1 indicates an error, in which case the errno global variable is set.

значение по значениюerrno value ОписаниеDescription
E2BIGE2BIG Пространство, требуемое для аргументов и параметров среды, превышает 32 КБ.The space required for the arguments and environment settings exceeds 32 KB.
еакцесEACCES Указанный файл имеет нарушение блокировки или общего доступа.The specified file has a locking or sharing violation.
еинвалEINVAL Недопустимый параметр.Invalid parameter.
EMFILEEMFILE Открыто слишком много файлов (указанный файл необходимо открыть и определить, является ли он исполняемым).Too many files open (the specified file must be opened to determine whether it is executable).
еноентENOENT Файл или путь не найдены.The file or path not found.
ENOEXECENOEXEC Указанный файл не является исполняемым или имеет недопустимый формат исполняемого файла.The specified file is not executable or has an invalid executable-file format.
еномемENOMEM Недостаточно доступной памяти для выполнения нового процесса; либо доступная память повреждена, либо существует недопустимый блок, что указывает на неправильное выделение памяти для процесса, а значит вызывающий процесс был выделен ненадлежащим образом.Not enough memory is available to execute the new process; the available memory has been corrupted; or an invalid block exists, indicating that the calling process was not allocated properly.

Дополнительные сведения об этих и других кодах возврата см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.For more information about these and other return codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

КомментарииRemarks

Каждая из этих функций загружает и выполняет новый процесс, передавая каждый аргумент командной строки как отдельный параметр и используя переменную среды path для поиска файла для выполнения.Each of these functions loads and executes a new process, passing each command-line argument as a separate parameter and using the PATH environment variable to find the file to execute.

Функции _execlp проверяют свои параметры.The _execlp functions validate their parameters. Если кмднаме или arg0 является пустым указателем или пустой строкой, эти функции вызывают обработчик недопустимых параметров, как описано в разделе Проверка параметров.If cmdname or arg0 is a null pointer or empty string, these functions invoke the invalid parameter handler as described in Parameter Validation. Если выполнение может быть продолжено, эти функции устанавливают значение еинвал и возвращают-1.If execution is allowed to continue, these functions set errno to EINVAL and return -1. Ни один новый процесс не запущен.No new process is launched.

ТребованияRequirements

ФункцияFunction Обязательный заголовокRequired header Необязательный заголовокOptional header
_execlp_execlp <process.h> <errno.h>
_wexeclp_wexeclp <process.h> или <wchar.h><process.h> or <wchar.h> <errno.h>

Дополнительные сведения о совместимости см. в разделе Compatibility.For more compatibility information, see Compatibility.

ПримерExample

См. пример в разделе Функции _exec, _wexec.See the example in _exec, _wexec Functions.

См. также разделSee also

Управление процессами и средойProcess and Environment Control
_exec, функции _wexec_exec, _wexec Functions
рвалabort
atexitatexit
exit, _Exit, _exitexit, _Exit, _exit
_onexit, _onexit_m_onexit, _onexit_m
_spawn, функции _wspawn_spawn, _wspawn Functions
system, _wsystemsystem, _wsystem