_execve, _wexecve

Las cargas y ejecutan los nuevos procesos secundarios.

Nota importanteImportante

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 _execve( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecve( 
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

Parámetros

  • cmdname
    Ruta de acceso del archivo a ejecutarse.

  • argv
    Matriz 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 una matriz de punteros a los argumentos de línea de comandos y una matriz de punteros a la configuración del entorno.

_execve y _wexecve validan sus parámetros.Si cmdname es un puntero null, o si argv es un puntero NULL, puntero a una matriz vacía, o si la matriz contiene una cadena vacía como primer argumento, 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 proceso.

Requisitos

Función

Encabezado necesario

Encabezado opcional

_execve

<process.h>

<errno.h>

_wexecve

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

Equivalente en .NET Framework

Vea también

Referencia

Proceso y control ambiental

_exec, funciones de _wexec

abort

atexit

exit, _exit

_onexit, _onexit_m

_spawn, funciones de _wspawn

system, _wsystem