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

ParametriParameters

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

argv
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. 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, passa una matrice di puntatori agli argomenti della riga di comando e usa la variabile di ambiente PATH 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.

Le funzioni _execvp convalidano i propri parametri.The _execvp functions validate their parameters. Se cmdname è un puntatore Null o se argv è un puntatore Null, un 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 Parameter Validation (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 su 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 <process.h><process.h> <errno.h><errno.h>
_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 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