_execlpe, _wexeclpe

Artículo
04/10/2013

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 _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 a ejecutarse.
arg0, ...argn
Lista de punteros a los parámetros.
envp
Matriz de punteros a la configuración del entorno.

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.
EMFILE	Demasiados archivos abiertos (el archivo especificado se debe abrir para determinar si es ejecutable).
ENOENT	El archivo o la ruta no encontrada.
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.

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

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

Las funciones de _execlpe validan sus parámetros.Si cmdname o arg0 es punteros 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 retorno -1.No se inicia un nuevo proceso.