_execl, _wexecl

  • Artículo

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 _execl(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL
);
intptr_t _wexecl(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL
);

Parámetros

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

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

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 Parámetro no válido (uno o varios parámetros eran un puntero nulo o una cadena vacía).
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, lo que indica que el proceso de llamada no se asignó correctamente.

Comentarios

Cada una de estas funciones carga y ejecuta un proceso nuevo, pasando cada argumento de la línea de comandos como parámetro independiente. El primer argumento es el nombre del comando o el archivo ejecutable, y el segundo argumento debe ser igual que el primero. Se convierte en argv[0] en el proceso ejecutado. El tercer argumento es el primer argumento, argv[1], del proceso que se está ejecutando.

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

Requisitos

Función Encabezado necesario Encabezado opcional
_execl <process.h> <errno.h>
_wexecl <process.h> o <wchar.h> <errno.h>

Para obtener más información sobre compatibilidad, 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