Condividi tramite


_execlpe, _wexeclpe

Carica ed esegue i nuovi processi figlio.

Nota importanteImportante

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.

Equivalente .NET Framework

Vedere anche

Riferimenti

Processo e controllo ambiente

_exec, funzioni di _wexec

abort

atexit

exit, _exit

_onexit, _onexit_m

_spawn, funzioni di _wspawn

system, _wsystem