_execl, _wexecl

Article
03/26/2013

Le chargement et exécution de nouveaux processus enfant.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.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 
);

Paramètres

cmdname
Chemin d'accès du fichier à exécuter.
arg0, ...argn
Liste des pointeurs vers des paramètres.

Valeur de retour

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

valeur errno	Description
E2BIG	L'espace requis pour les arguments et 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 s'agissait d'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 le chemin d'accès est introuvable.
ENOEXEC	Le fichier spécifié n'est pas exécutable ou un format de fichier exécutable non valide.
ENOMEM	Mémoire insuffisante est disponible pour exécuter le nouveau processus ; la mémoire a été endommagé ; 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, en passant chaque argument de ligne de commande comme paramètre distinct.Le premier argument est la commande ou le nom 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], le processus en cours de exécution.

Les fonctions d' _execl validez leurs paramètres.Si cmdname ou arg0 est un pointeur null ou une chaîne vide, ces fonctions appelle le gestionnaire de paramètre non valide comme décrit dans Validation des paramètres s'il permet à l'exécution pour continuer, ces errno défini par fonctions à EINVAL et retourner -1.Aucun nouveau processus n'est exécuté.