_execvp, _wexecvp_execvp, _wexecvp

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 _execvp(
   const char *cmdname,
   const char *const *argv
);
intptr_t _wexecvp(
   const wchar_t *cmdname,
   const wchar_t *const *argv
);

ParametriParameters

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

argvargv
Matrice di puntatori ai parametri.Array 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 una matrice di puntatori agli argomenti della riga di comando e utilizzando il percorso variabile di ambiente per individuare il file da eseguire.Each of these functions loads and executes a new process, passing an array of pointers to command-line arguments and using the PATH environment variable to find the file to execute.

Il execvp funzioni convalidano i propri parametri.The _execvp functions validate their parameters. Se il cmdname è un puntatore null, o argv è un puntatore null, puntatore a una matrice vuota, o se la matrice contiene una stringa vuota come primo argomento, queste funzioni richiamano il gestore di parametri non validi come descritto in convalida dei parametri.If the cmdname is a null pointer, or argv is a null pointer, pointer to an empty array, or if the array contains an empty string as the first argument, these functions invoke the invalid parameter handler as described in Parameter Validation. Se l'esecuzione può continuare, queste funzioni impostano errno alla EINVAL e restituiscono -1.If execution is allowed to continue, these functions set errno to EINVAL and return -1. Nessun processo viene avviato.No process is launched.

RequisitiRequirements

FunzioneFunction Intestazione obbligatoriaRequired header Intestazione facoltativaOptional header
_execvp_execvp <process.h><process.h> <errno.h><errno.h>
_wexecvp_wexecvp <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