_execle, _wexecle
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 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 vers des paramètres.envp
Tableau de pointeurs vers des paramètres d'environnement.
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 de 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. |
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, ce qui indique que le processus appelant n'a pas été alloué correctement. |
Pour plus d'informations sur ces codes de retour, consultez l' _doserrno, errno, _sys_errlist, et _sys_nerr.
Notes
Chacune de ces fonctions charge et exécute un nouveau processus, et passe chaque argument de ligne de commande comme paramètre distinct et passe un tableau de pointeurs vers les paramètres d'environnement.
Les fonctions d' _execle 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.Si est autorisé à l'exécution pour continuer, ces errno défini par fonctions à EINVAL et à retourner -1.Aucun nouveau processus n'est activé.
Configuration requise
Fonction |
En-tête requis |
En-tête facultatif |
---|---|---|
_execle |
<process.h> |
<errno.h> |
_wexecle |
<process.h> ou <wchar.h> |
<errno.h> |
Pour plus d'informations, consultez Compatibilité.
Exemple
Consultez l'exemple dans _exec, fonctions de _wexec.