_execl, _wexecl

Charge et exécute les nouveaux processus enfant.

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 dans les applications de la plateforme Windows universelle.

Syntaxe

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
);

Paramètres

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

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

Valeur retournée

Si elle réussit, ces fonctions ne reviennent pas au processus appelant. Une valeur de retour de -1 indique une erreur, auquel cas la errno variable globale est définie.

Valeur errno	Description
E2BIG	L’espace requis pour les arguments et les paramètres d’environnement dépasse 32 Ko.
EACCES	Le fichier spécifié possède un verrou ou une violation de partage.
EINVAL	Paramètre non valide (un ou plusieurs des paramètres étaient un pointeur null ou une chaîne vide).
EMFILE	Trop de fichiers ouverts (le fichier spécifié doit être ouvert pour déterminer s’il s’agit d’un fichier exécutable).
ENOENT	Le fichier ou le chemin d’accès est introuvable.
ENOEXEC	Le fichier spécifié n’est pas exécutable ou a un format de fichier exécutable non valide.
ENOMEM	La mémoire insuffisante est disponible pour exécuter le nouveau processus ; la mémoire disponible a été endommagée ; ou un bloc non valide existe, indiquant que le processus appelant n’a pas été alloué correctement.

Notes

Chacune de ces fonctions charge et exécute un nouveau processus, passant chaque argument de ligne de commande en tant que paramètre distinct. Le premier argument est la commande ou le nom du fichier exécutable, tandis que le deuxième argument doit être le même que le premier. Il devient argv[0] dans le processus exécuté. Le troisième argument est le premier argument, argv[1], du processus en cours d’exécution.

Les fonctions _execl valident leurs paramètres. cmdname Si l’un ou arg0 l’autre est un pointeur Null ou une chaîne vide, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans La validation de paramètre si l’exécution est autorisée à continuer, ces fonctions sont définies errno EINVAL sur et retournent -1. Aucun nouveau processus n'est exécuté.

Spécifications

Fonction	En-tête requis	En-tête facultatif
_execl	<process.h>	<errno.h>
_wexecl	<process.h> ou <wchar.h>	<errno.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Consultez l’exemple dans _exec, _wexec fonctions.

Voir aussi

Processus et contrôle d’environnement
_exec, fonctions _wexec
abort
atexit
exit, , _Exit_exit
_onexit, _onexit_m
_spawn, fonctions _wspawn
system, _wsystem