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

_execvpe, _wexecvpe

 

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, voir 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 
);

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.

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 nécessaire aux arguments et aux 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

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, ce qui indique 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.

Chacune de ces fonctions charge et exécute un nouveau processus, passe un tableau de pointeurs à des arguments de ligne de commande et un tableau de pointeurs aux 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 désignant un tableau vide ou un pointeur désignant un tableau dont le premier argument est une chaîne vide, ces fonctions appellent le gestionnaire de paramètres non valides, 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

Function

En-tête requis

En-tête facultatif

_execvpe

<process.h>

<errno.h>

_wexecvpe

<process.h> ou <wchar.h>

<errno.h>

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

Exemple

Consultez l'exemple de _exec, _wexec, fonctions.

Afficher: