_execvpe, _wexecvpe

Article
03/26/2013

Charge et processus enfant de passe nouveaux.

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 _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 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.
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 derniers et d'autres codes de retour, consultez errno, _doserrno, _sys_errlist, et _sys_nerr.

Notes

Chacune de ces fonctions charge et exécute un nouveau processus, et passe 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 d' PATH pour rechercher le fichier à exécuter.

Les fonctions d' _execvpe validez leurs paramètres.Si cmdname est un pointeur null, ou si argv est un pointeur null, un pointeur vers un tableau vide, ou un pointeur vers un tableau qui contient une chaîne vide comme premier argument, 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 processus n'est activé.