Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

_execl, _wexecl

 

Charge et exécute les nouveaux processus enfant.

System_CAPS_importantImportant

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

cmdname

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

arg0, ...argn

Liste de pointeurs vers les paramètres.

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 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 paramètres est 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 est exécutable).

ENOENT

Le fichier ou 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

Mémoire insuffisante pour exécuter le nouveau processus ; la mémoire disponible est endommagée ; ou il existe un bloc non valide, indiquant que le processus appelant n'a pas été alloué correctement.

Chacune de ces fonctions charge et exécute un nouveau processus, en passant chaque argument de ligne de commande comme paramètre séparé.Le premier argument est le nom du fichier de commandes ou de fichier exécutable, et le deuxième argument doit être identique au premier.Elle 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.

Ces fonctions _execl 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 à EINVAL et retournent -1.Aucun nouveau processus n'est généré.

Configuration requise

Function

En-tête requis

En-tête facultatif

_execl

<process.h>

<errno.h>

_wexecl

<process.h> or <wchar.h>

<errno.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

Consultez l'exemple de Fonctions _exec, _wexec.

Afficher: