Compartir a través de


_execlpe, _wexeclpe

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 _execlpe(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp
);
intptr_t _wexeclpe(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *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 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 El parámetro no es válido.
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.

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

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 y pasando también una matriz de punteros a la configuración del entorno. Estas funciones usan la variable de entorno PATH para buscar el archivo que se va a ejecutar.

Las funciones _execlpe 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 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
_execlpe <process.h> <errno.h>
_wexeclpe <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