_execle, _wexecle

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Carga y ejecuta nuevos procesos secundarios.

System_CAPS_ICON_important.jpg Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para más información, vea Funciones de CRT no admitidas con /ZW.

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.

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 errnoDescripción
E2BIGEl espacio necesario para los argumentos y la configuración de entorno supera los 32 KB.
EACCESEl archivo especificado tiene un bloqueo o una infracción de uso compartido.
EINVALParámetro no válido.
EMFILEHay demasiados archivos abiertos. (Se debe abrir el archivo especificado para determinar si es ejecutable).
ENOENTNo se encuentra el archivo o la ruta de acceso.
ENOEXECEl archivo especificado no es ejecutable o tiene un formato de archivo ejecutable no válido.
ENOMEMNo hay memoria suficiente para ejecutar el nuevo proceso; la memoria disponible se ha dañado o existe un bloque no válido que indica que el proceso de llamada no se asignó correctamente.

Para obtener más información acerca de estos códigos de retorno, vea _doserrno, errno, _sys_errlist y _sys_nerr.

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 el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, estas funciones establecen errno en EINVAL y devuelven -1. No se inicia ningún proceso nuevo.

FunciónEncabezado necesarioEncabezado opcional
_execle<process.h><errno.h>
_wexecle<process.h> o <wchar.h><errno.h>

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

Vea el ejemplo de funciones _exec y _wexec.

Control de proceso y entorno
_exec, _wexec (funciones)
anular
atexit
salir, _Exit, _exit
_onexit, _onexit_m
_spawn, _wspawn (funciones)
sistema, _wsystem

Mostrar: