_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 altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (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

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

arg0,... argnarg0, ... 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. Valore restituito di -1 indica un errore, nel qual caso il errno (variabile globale) è impostata.A return value of -1 indicates an error, in which case the errno global variable is set.

errno valoreerrno value DescrizioneDescription
E2BIGE2BIG 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.
EACCESEACCES Il file specificato dispone di una violazione di blocco o di condivisione.The specified file has a locking or sharing violation.
EINVALEINVAL Parametro non valido.Invalid parameter.
EMFILEEMFILE 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).
ENOENTENOENT File o percorso non trovato.The file or path not found.
ENOEXECENOEXEC 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.
ENOMEMENOMEM 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 il percorso variabile di ambiente per individuare 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.

Il execlp funzioni convalidano i propri parametri.The _execlp functions validate their parameters. Se cmdname oppure arg0 è un puntatore null o stringhe vuote, queste funzioni richiamano il gestore di parametri non validi come descritto in 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 al 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_execlp <process.h><process.h> <errno.h><errno.h>
_wexeclp_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 di processi e ambienteProcess and Environment Control
Funzioni _exec, _wexec_exec, _wexec Functions
abortabort
atexitatexit
exit, _Exit, _exitexit, _Exit, _exit
_onexit, _onexit_m_onexit, _onexit_m
Funzioni _spawn, _wspawn_spawn, _wspawn Functions
system, _wsystemsystem, _wsystem