Condividi tramite


_execl, _wexecl

Carica ed esegue nuovi processi figlio.

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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 di puntatori ai parametri.

Valore restituito

In caso di esito positivo, queste funzioni non tornano al processo chiamante. Il valore restituito -1 indica un errore, nel qual caso viene impostata la errno variabile globale.

Valore errno Descrizione
E2BIG Lo spazio necessario per gli argomenti e le impostazioni di ambiente supera 32 KB.
EACCES Il file specificato dispone di una violazione di blocco o di condivisione.
EINVAL Parametro non valido (uno o più parametri sono puntatori Null o stringhe vuote).
EMFILE Troppi file aperti (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 esiste un blocco non valido, a indicare che il processo chiamante non è stato allocato correttamente.

Osservazioni:

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], del processo in esecuzione.

Le funzioni _execl convalidano i propri parametri. cmdname Se o arg0 è un puntatore Null o una stringa vuota, queste funzioni richiamano il gestore di parametri non validi come descritto in Convalida dei parametri Se l'esecuzione può continuare, queste funzioni sono impostate su errno EINVAL e restituiscono -1. Non viene eseguito alcun nuovo processo.

Requisiti

Funzione Intestazione obbligatoria Intestazione facoltativa
_execl <process.h> <errno.h>
_wexecl <process.h> o <wchar.h> <errno.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

Vedere l'esempio in _execfunzioni_wexec .

Vedi anche

Processo e controllo dell'ambiente
_exec, _wexec funzioni
abort
atexit
exit, _Exit, _exit
_onexit, _onexit_m
_spawn, _wspawn funzioni
system, _wsystem