Compartir a través de


_execle, _wexecle

Carga y ejecuta nuevos procesos secundarios.

Nota importanteImportante

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 _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 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 que se requiere 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.

EMFILE

Demasiados archivos abiertos. (El archivo especificado se debe abrir 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 está disponible ejecutar el nuevo proceso; se ha dañado la memoria disponible; o un bloque no existe, que indica que el proceso de llamada no fue asignado correctamente.

Para obtener más información sobre estos códigos devueltos, vea _doserrno, errno, _sys_errlist, y _sys_nerr.

Comentarios

Cada una de estas funciones se carga y ejecuta un nuevo proceso, y pasa cada argumento de línea de comandos como parámetro independiente y pasa una matriz de punteros a la configuración del entorno.

Las funciones _execle 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 de parámetro, tal y 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, vea Compatibilidad.

Ejemplo

Consulte el ejemplo de _exec, _wexec (Funciones).

Equivalente en .NET Framework

Vea también

Referencia

Control de proceso y de entorno

_exec, _wexec (Funciones)

abort

atexit

exit, _exit

_onexit, _onexit_m

_spawn, _wspawn (Funciones)

system, _wsystem