_execl, _wexecl
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 con /ZW.
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 ejecutan correctamente, estas funciones no vuelven al proceso de llamada. Un valor devuelto de –1 indica un error, en cuyo caso se establece la variable global errno.
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 (se debe abrir el archivo especificado 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 |
Memoria insuficiente para ejecutar el nuevo proceso; la memoria disponible se ha dañado; 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 cmdname o arg0 es un puntero nulo o una cadena vacía, estas funciones invocan el 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 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, vea Compatibilidad.
Ejemplo
Vea el ejemplo de Funciones _exec y _wexec.