Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

_spawnle, _wspawnle

Crea y ejecuta un nuevo proceso.

Nota importante 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 _spawnle(
   int mode,
   const char *cmdname,
   const char *arg0,
   const char *arg1,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wspawnle(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *arg0,
   const wchar_t *arg1,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *const *envp 
);

mode

Modo de ejecución para el proceso de llamada.

cmdname

Ruta de acceso del archivo que se ejecutará.

arg0, arg1, ... argn

Lista de punteros a argumentos. El argumento de arg0 suele ser un puntero a cmdname. Los argumentos arg1 con argn son punteros a cadenas de caracteres que forman la nueva lista de argumentos. Después de argn, debe haber puntero de NULL para marcar el final de la lista de argumentos.

envp

Matriz de punteros a la configuración del entorno.

El valor devuelto de _spawnle sincrónico o de _wspawnle (_P_WAIT especificado para mode) es el estado del nuevo proceso. El valor devuelto de _spawnle asincrónico o de _wspawnle (_P_NOWAIT o _P_NOWAITO especificado para mode) es el identificador de proceso. El estado de salida es 0 si el proceso finalizó normalmente. Puede establecer el estado de salida en un valor distinto de cero si el proceso generado llama específicamente la rutina de exit con un argumento distinto de cero. Si el nuevo proceso no estableció un estado de salida positivo, un estado de salida positivo indica un resultado anormal con un anulación o una interrupción. Un valor devuelto de – 1 indica un error (el nuevo proceso no se inicia). En este caso, errno se establece en uno de los valores siguientes.

E2BIG

La lista de argumentos supera los 1024 bytes.

EINVAL

el argumento de mode no es válido.

ENOENT

El archivo o la ruta no se encuentra.

ENOEXEC

El archivo especificado no es ejecutable no tiene formato de archivo ejecutable no válido.

ENOMEM

Memoria insuficiente está disponible ejecutar el nuevo proceso.

Para obtener más información sobre éstos y otros códigos de retorno, vea _doserrno, errno, _sys_errlist, y _sys_nerr.

Cada una de estas funciones crea y ejecuta un nuevo proceso, pasando cada argumento de línea de comandos como parámetro independiente y también pasando una matriz de punteros a la configuración del entorno.

Estas funciones validan sus parámetros. Si cmdname o arg0 es una cadena vacía o puntero null, 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 errno establecido el volver a EINVAL, y -1. No se generar ningún nuevo proceso.

Rutina

Encabezado necesario

_spawnle

<process.h>

_wspawnle

<stdio.h> o <wchar.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Adiciones de comunidad

AGREGAR
Mostrar: