_execvpe, _wexecvpe

Articolo
03/26/2013

Carica e processi figlio di esecuzione nuovi.

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

intptr_t _execvpe( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecvpe( 
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

Parametri

cmdname
Il percorso del file da eseguire.
argv
Matrice di puntatori ai parametri.
envp
Matrice di puntatori alle impostazioni di ambiente.

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 richiesto per gli argomenti e di ambiente supera 32 KB.
EACCES	Il file specificato ha una violazione di blocco o di condivisione.
EMFILE	Troppi file aperti.(Il file specificato sia aperto per determinare se sia eseguibile.)
ENOENT	Il file o il percorso non viene trovato.
ENOEXEC	Il file specificato non è eseguibile o ha un formato di file eseguibile non valido.
ENOMEM	Memoria insufficiente è disponibile per eseguire il nuovo processo; la memoria disponibile è danneggiato; o un blocco non valido esiste, che indica che il processo chiamante non è stato allocato correttamente.

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

Note

Ognuna di queste funzioni carica ed esegue un nuovo processo e passa una matrice di puntatori agli argomenti della riga di comando e una matrice di puntatori alle impostazioni di ambiente.Queste funzioni utilizzano la variabile di ambiente PATH per individuare il file da eseguire.

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