_execl, _wexecl
Las cargas y ejecutan los nuevos procesos secundarios.
Importante |
---|
Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles 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 ejecutará.arg0, ...argn
Lista de punteros a los parámetros.
Valor devuelto
Si son correctas, estas funciones no cambian al proceso de llamada.Un valor devuelto de – 1 indica un error, en cuyo caso se establece la variable global de errno.
valor de errno |
Descripción |
---|---|
E2BIG |
El espacio necesario para los argumentos y la configuración de entorno supera 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 puntero null o una cadena vacía). |
EMFILE |
Demasiados archivos abiertos (el archivo especificado se debe abrir para determinar si es ejecutable). |
ENOENT |
El archivo o la ruta no se encuentra. |
ENOEXEC |
El archivo especificado no es ejecutable o tiene un formato de archivo ejecutable no válido. |
ENOMEM |
Memoria insuficiente está disponible ejecutar el nuevo proceso; se ha dañado la memoria disponible; o un bloque no existe, lo que indica que el proceso de llamada no fue asignado correctamente. |
Comentarios
Cada una de estas funciones se carga y ejecuta un nuevo proceso, pasando cada argumento de línea de comandos como parámetro independiente.El primer argumento es el nombre del comando o 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], el proceso ejecutado.
Las funciones de _execl validan sus parámetros.Si cmdname o arg0 es un puntero null o una cadena vacía, estas funciones se invoca el controlador no válido del parámetro tal como se describe en Validación de parámetros si la ejecución puede continuar, este errno establecido funciones a EINVAL y devuelva -1.No se ejecuta ningún nuevo proceso.
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 de compatibilidad, vea Compatibilidad en la Introducción.
Ejemplo
Vea el ejemplo de _exec, funciones de _wexec.