_execle, _wexecle_execle, _wexecle

Carica ed esegue nuovi processi figlio.Loads and executes new child processes.

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime.This API cannot be used in applications that execute in the Windows Runtime. Per ulteriori informazioni, vedere funzioni CRT non supportate nelle App Universal Windows Platform.For more information, see CRT functions not supported in Universal Windows Platform apps.

SintassiSyntax

intptr_t _execle(   
   const char *cmdname,  
   const char *arg0,  
   ... const char *argn,  
   NULL,  
   const char *const *envp   
);  
intptr_t _wexecle(   
   const wchar_t *cmdname,  
   const wchar_t *arg0,  
   ... const wchar_t *argn,  
   NULL,  
   const char *const *envp   
);  

ParametriParameters

cmdname
Percorso del file da eseguire.Path of the file to execute.

arg0, ... argn
Elenco di puntatori ai parametri.List of pointers to parameters.

envp
Matrice di puntatori alle impostazioni d'ambiente.Array of pointers to environment settings.

Valore restituitoReturn Value

Se l'operazione riesce, le funzioni non ritornano al processo chiamante.If successful, these functions do not return to the calling process. Il valore restituito-1 indica un errore, nel qual caso il errno è impostata la variabile globale.A return value of -1 indicates an error, in which case the errno global variable is set.

Valore di errnoerrno value DescrizioneDescription
E2BIG Lo spazio necessario per gli argomenti e le impostazioni di ambiente supera 32 KB.The space that's required for the arguments and the environment settings exceeds 32 KB.
EACCES Il file specificato dispone di una violazione di blocco o di condivisione.The specified file has a locking or sharing violation.
EINVAL Parametro non valido.Invalid parameter.
EMFILE Sono aperti troppi file.Too many files are open. (Il file specificato deve essere aperto per determinare se sia eseguibile).(The specified file must be opened to determine whether it is executable.)
ENOENT Il file o il percorso non è stato trovato.The file or path is not found.
ENOEXEC Il file specificato non è eseguibile o il formato del file eseguibile non è valido.The specified file is not executable or has an invalid executable-file format.
ENOMEM Memoria insufficiente per eseguire il nuovo processo; la memoria disponibile è stata danneggiata; o esiste un blocco non valido che indica che il processo chiamante non è stato allocato correttamente.Not enough memory is available to execute the new process; the available memory has been corrupted; or an invalid block exists, which indicates that the calling process was not allocated correctly.

Per altre informazioni su questi codici restituiti, vedere _doserrno, errno, _sys_errlist e _sys_nerr.For more information about these return codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

NoteRemarks

Ognuna di queste funzioni carica ed esegue un nuovo processo, passa ogni argomento della riga di comando come parametro separato e passa una matrice di puntatori alle impostazioni di ambiente.Each of these functions loads and executes a new process, and passes each command-line argument as a separate parameter and passes an array of pointers to environment settings.

Le funzioni _execle convalidano i propri parametri.The _execle functions validate their parameters. Se cmdname o arg0 sono puntatori Null o stringhe vuote, queste funzioni richiamano il gestore di parametri non validi, come descritto in Parameter Validation (Convalida dei parametri).If cmdname or arg0 is a null pointer or an empty string, these functions invoke the invalid parameter handler, as described in Parameter Validation. Se l'esecuzione può continuare, queste funzioni impostano errno su EINVAL e restituiscono -1.If execution is allowed to continue, these functions set errno to EINVAL and return -1. Non viene avviato alcun nuovo processo.No new process is launched.

RequisitiRequirements

FunzioneFunction Intestazione obbligatoriaRequired header Intestazione facoltativaOptional header
_execle <process.h><process.h> <errno.h><errno.h>
_wexecle <process.h> o <wchar.h><process.h> or <wchar.h> <errno.h><errno.h>

Per altre informazioni, vedere Compatibility (Compatibilità).For more information, see Compatibility.

EsempioExample

Vedere l'esempio in Funzioni _exec, _wexec.See the example in _exec, _wexec Functions.

Vedere ancheSee Also

Controllo processo e ambiente Process and Environment Control
Funzioni _exec, _wexec _exec, _wexec Functions
abort abort
atexit atexit
exit, _Exit, _exit exit, _Exit, _exit
_onexit, _onexit_m _onexit, _onexit_m
Funzioni _spawn, _wspawn _spawn, _wspawn Functions
system, _wsystemsystem, _wsystem