_execle, _wexecle

Carga y ejecuta nuevos procesos secundarios.

Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas en aplicaciones de la Plataforma universal de Windows.

Sintaxis

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
);

Parámetros

cmdname
Ruta de acceso del archivo que se va a ejecutar.

arg0, ... argN
Lista de punteros a parámetros.

envp
Matriz de punteros a la configuración del entorno.

Valor devuelto

Si se ejecuta correctamente, estas funciones no vuelven al proceso de llamada. Un valor devuelto de -1 indica un error, en cuyo caso se establece la errno variable global.

Valor de errno	Descripción
E2BIG	El espacio necesario para los argumentos y la configuración de entorno supera los 32 KB.
EACCES	El archivo especificado tiene un bloqueo o una infracción de uso compartido.
EINVAL	El parámetro no es válido.
EMFILE	Hay demasiados archivos abiertos. (El archivo especificado debe abrirse para determinar si es ejecutable).
ENOENT	No se encuentra el archivo o la ruta de acceso.
ENOEXEC	El archivo especificado no es ejecutable o tiene un formato de archivo ejecutable no válido.
ENOMEM	No hay suficiente memoria disponible para ejecutar el nuevo proceso; la memoria disponible está dañada; o existe un bloque no válido, que indica que el proceso de llamada no se asignó correctamente.

Para obtener más información sobre estos códigos de retorno, vea errno, _doserrno, _sys_errlisty _sys_nerr.

Comentarios

Cada una de estas funciones carga y ejecuta un proceso nuevo, y pasa cada argumento de la línea de comandos como parámetro independiente, así como una matriz de punteros a la configuración del entorno.

Las funciones _execle validan sus parámetros. Si cmdname o arg0 es un puntero nulo o una cadena vacía, estas funciones invocan al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones establecen errno en EINVAL y devuelven -1. No se inicia ningún proceso nuevo.

Requisitos

Función	Encabezado necesario	Encabezado opcional
_execle	<process.h>	<errno.h>
_wexecle	<process.h> o <wchar.h>	<errno.h>

Para obtener más información, consulte Compatibilidad.

Ejemplo

Vea el ejemplo de , _exec_wexec functions.

Consulte también

Control de procesos y entornos
Funciones _exec, _wexec
abort
atexit
exit, _Exit, _exit
_onexit, _onexit_m
Funciones _spawn, _wspawn
system, _wsystem