_execvp, _wexecvp

Articolo
06/09/2015

Carica ed esegue i nuovi processi figlio.

Importante

Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

intptr_t _execvp( 
   const char *cmdname,
   const char *const *argv 
);
intptr_t _wexecvp( 
   const wchar_t *cmdname,
   const wchar_t *const *argv 
);

Parametri

cmdname
Il percorso del file da eseguire.
argv
Matrice di puntatori ai parametri.

Valore restituito

Se vengono completate correttamente, queste funzioni non restituiscono nessun valore al processo chiamante. Un valore restituito pari a –1 indica un errore, in questo caso viene impostata la variabile globale errno.

Valore errno	Descrizione
E2BIG	Lo spazio necessario per gli argomenti e le impostazioni di ambiente supera 32 KB.
EACCES	Il file specificato ha una violazione di blocco o di condivisione.
EINVAL	Parametro non valido.
EMFILE	Vengono aperti troppi file (il file specificato deve essere aperto per determinare se è eseguibile).
ENOENT	Impossibile trovare il file o il percorso.
ENOEXEC	Il file specificato non è eseguibile o ha un formato di file eseguibile non valido.
ENOMEM	Memoria insufficiente per eseguire il nuovo processo; la memoria disponibile è stata danneggiata; o c'è un blocco non valido, che indica che il processo chiamante non è stato allocato correttamente.

Per ulteriori informazioni su questi e altri codici restituiti, vedere _doserrno, errno, _sys_errlist, e _sys_nerr.

Note

Ognuna di queste funzioni viene caricata ed esegue un nuovo processo, che passa una matrice di puntatori agli argomenti della riga di comando e utilizza la variabile di ambiente PATH per individuare il file da eseguire.

Le funzioni _execvp convalidano i parametri. Se cmdname è un puntatore null oppure argv è un puntatore null, o un puntatore ad una matrice vuota oppure se la matrice contiene una stringa vuota come primo argomento, queste funzioni richiamano il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni impostano errno su EINVAL e restituiscono -1. Nessun processo viene avviato.