_execlpe, _wexeclpe

Article
06/09/2015

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

Paramètres

cmdname
Chemin d'accès du fichier à exécuter.
arg0, ...argn
Liste de pointeurs vers les paramètres.
envp
Tableau de pointeurs vers les paramètres d'environnement.

Valeur de retour

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 de 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.
EMFILE	Trop de fichiers ouverts (le fichier spécifié doit être ouvert pour déterminer s'il est exécutable).
ENOENT	Fichier ou chemin d'accès 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.

Pour plus d'informations sur ces codes de retour et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.

Notes

Chacune de ces fonctions charge et exécute un nouveau processus, en passant chaque argument de ligne de commande comme paramètre distinct et en passant également un tableau de pointeurs vers des paramètres d'environnement. Ces fonctions utilisent la variable d'environnement PATH pour rechercher le fichier à exécuter.

Les fonctions _execlpe valident leurs paramètres. Si soit cmdname ou arg0 est un pointeur null ou une chaîne de caractères vide, ces fonctions appellent le gestionnaire de paramètre non valide, 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 lancé.