Compartir a través de


_execv, _wexecv

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 con /ZW.

intptr_t _execv( 
   const char *cmdname,
   const char *const *argv 
);
intptr_t _wexecv( 
   const wchar_t *cmdname,
   const wchar_t *const *argv 
);

Parámetros

  • cmdname
    Ruta de acceso del archivo que se va a ejecutar.

  • argv
    Matriz de punteros a parámetros.

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

Parámetro no válido.

EMFILE

Hay demasiados archivos abiertos (se debe abrir el archivo especificado 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 para ejecutar el nuevo proceso; la memoria disponible se ha dañado; 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 _doserrno, errno, _sys_errlist y _sys_nerr.

Comentarios

Cada una de estas funciones carga y ejecuta un proceso nuevo, y pasa una matriz de punteros a los argumentos de la línea de comandos.

Las funciones _execv validan sus parámetros. Si cmdname es un puntero nulo, o si argv es un puntero nulo, un puntero a una matriz vacía, o la matriz contiene una cadena vacía como primer argumento, las funciones de _execv invocan el controlador de parámetros no válido, 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

_execv

<process.h>

<errno.h>

_wexecv

<process.h> o <wchar.h>

<errno.h>

Para obtener más información sobre compatibilidad, vea Compatibilidad.

Ejemplo

Vea el ejemplo de Funciones _exec y _wexec.

Equivalente en .NET Framework

Vea también

Referencia

Control de proceso y de entorno

_exec, _wexec (Funciones)

abort

atexit

exit, _exit

_onexit, _onexit_m

_spawn, _wspawn (Funciones)

system, _wsystem