Compartir a través de


_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