_spawnvpe, _wspawnvpe

Crée et exécute un nouveau processus.

Syntaxe

intptr_t _spawnvpe(
   int mode,
   const char *cmdname,
   const char *const *argv,
   const char *const *envp
);
intptr_t _wspawnvpe(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp
);

Paramètres

mode
Mode d’exécution du processus appelant

cmdname
Chemin du fichier à exécuter

argv
Tableau de pointeurs vers les arguments. L’argument argv[0] est généralement un pointeur vers un chemin en mode réel ou vers le nom du programme en mode protégé, et argv[1] par le biais argv[n] sont des pointeurs vers les chaînes de caractères formant la nouvelle liste d’arguments. L’argument argv[n+1] doit être un NULL pointeur pour marquer la fin de la liste d’arguments.

envp
Tableau de pointeurs désignant les paramètres d’environnement

Valeur retournée

La valeur de retour d’une routine _spawnvpe ou _wspawnvpe asynchrone (_P_WAIT spécifié pour mode) est l’état de sortie du nouveau processus. La valeur de retour d'une routine _spawnvpe ou _wspawnvpe asynchrone (_P_NOWAIT ou _P_NOWAITO spécifié pour mode) est le handle du processus. L'état de sortie est 0 si le processus s'est terminé normalement. Vous pouvez définir l'état de sortie à une valeur différente de zéro si le processus engendré appelle spécifiquement la routine exit avec un argument différent de zéro. Si le nouveau processus n’a pas défini explicitement d’état de sortie positif, un état de sortie positif indique une sortie anormale avec un abandon ou une interruption. Une valeur de retour de -1 indique une erreur (le nouveau processus n’est pas démarré). Dans ce cas, errno a l'une des valeurs suivantes :

Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

Chacune de ces fonctions crée et exécute un nouveau processus, passant un tableau de pointeurs vers des arguments de ligne de commande et un tableau de pointeurs vers des paramètres d’environnement. Ces fonctions utilisent la variable d'environnement PATH pour rechercher le fichier à exécuter.

Ces fonctions valident leurs paramètres. cmdname Si l’un ou argv l’autre est un pointeur Null, ou s’il argv pointe vers un pointeur Null ou argv[0] est une chaîne vide, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l'exécution est autorisée à se poursuivre, ces fonctions définissent errno avec la valeur EINVALet retournent -1. Aucun nouveau processus généré.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Consultez l’exemple dans _spawn, _wspawn fonctions.

Voir aussi

abort
atexit
_exec, fonctions _wexec
exit, , _Exit_exit
_flushall
_getmbcp
_onexit, _onexit_m
_setmbcp
system, _wsystem