_execlp, _wexeclp_execlp, _wexeclp

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 _execlp(   
   const char *cmdname,  
   const char *arg0,  
   ... const char *argn,  
   NULL   
);  
intptr_t _wexeclp(   
   const wchar_t *cmdname,  
   const wchar_t *arg0,  
   ... const wchar_t *argn,  
   NULL   
);  

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.

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 required for the arguments and 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 Troppi file aperti (il file specificato deve essere aperto per determinare se sia eseguibile).Too many files open (the specified file must be opened to determine whether it is executable).
ENOENT File o percorso non trovato.The file or path 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, indicating that the calling process was not allocated properly.

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

NoteRemarks

Ognuna di queste funzioni carica ed esegue un nuovo processo, passando ogni argomento della riga di comando come parametro separato e usando la variabile di ambiente PATH per trovare il file da eseguire.Each of these functions loads and executes a new process, passing each command-line argument as a separate parameter and using the PATH environment variable to find the file to execute.

Le funzioni _execlp convalidano i propri parametri.The _execlp 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 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
_execlp <process.h><process.h> <errno.h><errno.h>
_wexeclp <process.h> o <wchar.h><process.h> or <wchar.h> <errno.h><errno.h>

Per altre informazioni sulla compatibilità, vedere Compatibilità.For more compatibility 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