Partager via


_execlp, _wexeclp

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 les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

intptr_t _execlp( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL 
);
intptr_t _wexeclp( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL 
);

Paramètres

  • cmdname
    Chemin d'accès du fichier à exécuter.

  • arg0, ...argn
    Liste des pointeurs vers des paramètres.

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 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, indiquant que le processus appelant n'a pas été alloué correctement.

Pour plus d'informations sur ces derniers et d'autres codes de retour, consultez l' _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 l'utilisation la variable d'environnement d' PATH pour rechercher le fichier à exécuter.

Les fonctions d' _execlp 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

_execlp

<process.h>

<errno.h>

_wexeclp

<process.h> ou <wchar.h>

<errno.h>

Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.

Exemple

Consultez l'exemple de _exec, fonctions de _wexec.

Équivalent .NET Framework

Voir aussi

Référence

Processus et contrôle ambiance

_exec, fonctions de _wexec

abort

atexit

exit, _exit

_onexit, _onexit_m

_spawn, fonctions de _wspawn

system, _wsystem