_execlp, _wexeclp
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 _execlp(
const char *cmdname,
const char *arg0,
... const char *argn,
NULL
);
intptr_t _wexeclp(
const wchar_t *cmdname,
const wchar_t *arg0,
... const wchar_t *argn,
NULL
);
Parámetros
cmdname
Ruta de acceso del archivo a ejecutarse.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. |
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 mediante la variable de entorno PATH para buscar el archivo para ejecutarse.
Las funciones de _execlp 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 retorno -1.No se inicia un nuevo proceso.
Requisitos
Función |
Encabezado necesario |
Encabezado opcional |
---|---|---|
_execlp |
<process.h> |
<errno.h> |
_wexeclp |
<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.