_execl, _wexecl

Articolo
03/26/2013

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 _execl( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL 
);
intptr_t _wexecl(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL 
);

Parametri

cmdname
Percorso del file da eseguire.
arg0, ...argn
Elenco dei 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 di 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 (uno o più parametri è un puntatore null o una stringa vuota.
EMFILE	Vengono aperti troppi file (il file specificato deve essere aperto per determinare se è 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 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.

Note

Ognuna di queste funzioni carica ed esegue un nuovo processo, passando ogni argomento della riga di comando come parametro separato.Il primo argomento è il comando o il nome del file eseguibile e il secondo argomento deve essere uguale al primo.Diventa argv[0] nel processo eseguito.Il terzo argomento è il primo argomento, argv[1], il processo di cui viene eseguito.

Le funzioni _execl convalidano i parametri.Se cmdname o arg0 è un puntatore null o una stringa vuota, queste funzioni richiamare il gestore non valido di parametro come descritto in Convalida dei parametri se l'esecuzione è consentita per continuare, in questo errno impostato funzioni a EINVAL e restituiscono -1.Nessun nuovo processo viene eseguito.