_execle, _wexecle

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Charge et exécute les nouveaux processus enfant.

System_CAPS_ICON_important.jpg Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge avec /ZW.

intptr_t _execle(   
   const char *cmdname,  
   const char *arg0,  
   ... const char *argn,  
   NULL,  
   const char *const *envp   
);  
intptr_t _wexecle(   
   const wchar_t *cmdname,  
   const wchar_t *arg0,  
   ... const wchar_t *argn,  
   NULL,  
   const char *const *envp   
);  

Paramètres

cmdname
Chemin d’accès du fichier à exécuter.

arg0, ...``argn
Liste des pointeurs désignant les paramètres.

envp
Tableau de pointeurs vers les paramètres d'environnement.

En cas de réussite, ces fonctions ne retournent pas au processus appelant. Une valeur de retour égale à 1 indique une erreur, auquel cas la variable globale errno est définie.

Valeur errnoDescription
E2BIGL’espace nécessaire aux arguments et aux paramètres d’environnement dépasse 32 Ko.
EACCESLe fichier spécifié possède un verrou ou une violation de partage.
EINVALParamètre non valide.
EMFILETrop de fichiers sont ouverts. (Le fichier spécifié doit être ouvert pour déterminer s'il est exécutable.)
ENOENTFichier ou chemin d’accès introuvable.
ENOEXECLe fichier spécifié n'est pas exécutable ou a un format de fichier exécutable non valide.
ENOMEMMémoire insuffisante pour exécuter le nouveau processus ; la mémoire disponible est endommagée ; ou il existe un bloc non valide, ce qui indique que le processus appelant n'a pas été alloué correctement.

Pour plus d’informations sur ces codes de retour, voir _doserrno, errno, _sys_errlist et _sys_nerr.

Chacune de ces fonctions charge et exécute un nouveau processus, passe chaque argument de ligne de commande en tant que paramètre distinct et passe un tableau de pointeurs aux paramètres d’environnement.

Les fonctions _execle valident leurs paramètres. Si cmdname ou arg0 est un pointeur null ou une chaîne vide, ces fonctions appellent le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions définissent errno avec la valeur EINVAL et retournent -1. Aucun nouveau processus n'est lancé.

FonctionEn-tête requisEn-tête facultatif
_execle<process.h><errno.h>
_wexecle<process.h> ou <wchar.h><errno.h>

Pour plus d'informations, voir Compatibilité.

Consultez l’exemple de fonctions _exec, _wexec.

Processus de contrôle et d’environnement
_exec, _wexec, fonctions
abandonner
atexit
Exit, _Exit, _exit
_onexit, _onexit_m
_spawn, _wspawn, fonctions
système, _wsystem

Afficher: