_execlpe, _wexeclpe
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 _execlpe(
const char *cmdname,
const char *arg0,
... const char *argn,
NULL,
const char *const *envp
);
intptr_t _wexeclpe(
const wchar_t *cmdname,
const wchar_t *arg0,
... const wchar_t *argn,
NULL,
const wchar_t *const *envp
);
Parametri
cmdname
Il percorso del file da eseguire.arg0, ...argn
Un elenco 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 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 carica ed esegue un nuovo processo, passando ogni argomento della riga di comando come parametro separato 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 _execlpe convalidano i parametri.Se cmdname o arg0 sono puntatori null o stringhe vuote, queste funzioni richiamano il gestore di parametro non valido come descritto in Convalida dei parametri.Se l'esecuzione può continuare, queste funzioni impostano errno a EINVAL e restituiscono -1.Non viene avviato nessun nuovo processo.
Requisiti
Funzione |
Intestazione obbligatoria |
Intestazione facoltativa |
---|---|---|
_execlpe |
<process.h> |
<errno.h> |
_wexeclpe |
<process.h> o <wchar.h> |
<errno.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Esempio
Vedere l'esempio in Funzioni _exec, _wexec.