_execvpe, _wexecvpe
Charge et exécute les nouveaux processus enfants.
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 _execvpe(
const char *cmdname,
const char *const *argv,
const char *const *envp
);
intptr_t _wexecvpe(
const wchar_t *cmdname,
const wchar_t *const *argv,
const wchar_t *const *envp
);
Paramètres
cmdname
Chemin d'accès du fichier à exécuter.argv
Tableau 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. |
EMFILE |
Trop de fichiers sont 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. |
Pour plus d'informations sur ces codes de retour et autres, consultez errno, _doserrno, _sys_errlist et _sys_nerr.
Notes
Chacune de ces fonctions crée et exécute un nouveau processus, en passant un tableau de pointeurs vers des arguments de ligne de commande et un tableau de pointeurs vers les paramètres d'environnement. Ces fonctions utilisent la variable d'environnement PATH pour rechercher le fichier à exécuter.
Les fonctions _execvpe valident leurs paramètres. Si cmdname est un pointeur null, ou si argv est un pointeur null, un pointeur vers un tableau vide, ou si le tableau contient une chaîne vide comme premier argument, 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 avec la valeur EINVAL et retournent -1. Aucun processus lancé.
Configuration requise
Fonction |
En-tête requis |
En-tête facultatif |
---|---|---|
_execvpe |
<process.h> |
<errno.h> |
_wexecvpe |
<process.h> or <wchar.h> |
<errno.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité.
Exemple
Consultez l'exemple dans _exec, _wexec, fonctions.