_execvpe, _wexecvpe

  • Artículo

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 _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 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.
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, 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 una matriz de punteros a los argumentos de la 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. Estas funciones invocan al controlador de parámetros no válidos, como se describe en Validación de parámetros, cuando:

  • cmdname es un puntero nulo,
  • argv es un puntero nulo o puntero a una matriz vacía,
  • la matriz contiene una cadena vacía como primer argumento.

Si el controlador permite continuar la ejecución, estas funciones se establecen errno EINVALen y devuelven -1. No se inicia ningún proceso.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

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 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