_execle, _wexecle

Статья
04/10/2013

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

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

intptr_t _execle( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexecle( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const char *const *envp 
);

Параметры

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

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

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

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

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

Заметки

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

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