_execvpe, _wexecvpe
Cargas y procesos secundarios de las ejecuciones nuevos.
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 con /ZW.
intptr_t _execvpe(
const char *cmdname,
const char *const *argv,
const char *const *envp
);
intptr_t _wexecvpe(
const wchar_t *cmdname,
const wchar_t *const *argv,
const wchar_t *const *envp
);
Parámetros
cmdname
Ruta de acceso del archivo que se va a ejecutar.argv
Matriz 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. |
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 y otros códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.
Comentarios
Cada una de estas funciones se carga y ejecuta un nuevo proceso, y pasa una matriz de punteros a los argumentos de línea de comandos y 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 _execvpe validan sus parámetros. Si cmdname es un puntero null, o si argv es un puntero NULL, puntero a una matriz vacía, o un puntero a una matriz que contiene una cadena vacía como primer argumento, 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.
Requisitos
Función |
Encabezado necesario |
Encabezado opcional |
---|---|---|
_execvpe |
<process.h> |
<errno.h> |
_wexecvpe |
<process.h> o <wchar.h> |
<errno.h> |
Para obtener más información de compatibilidad, vea Compatibilidad.
Ejemplo
Consulte el ejemplo de _exec, _wexec (Funciones).