_spawnvp, _wspawnvp

Crée un processus et l'exécute.

Syntaxe

intptr_t _spawnvp(
   int mode,
   const char *cmdname,
   const char *const *argv
);
intptr_t _wspawnvp(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *const *argv
);

Paramètres

mode
Mode d'exécution de l'appel du processus.

cmdname
Chemin d'accès 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.

Valeur retournée

La valeur de retour d’une routine _spawnvp ou _wspawnvp asynchrone (_P_WAIT spécifié pour mode) est l’état de sortie du nouveau processus. La valeur de retour d'une routine _spawnvp ou _wspawnvp 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 attribuer à l'état de sortie une valeur différente de zéro si le processus engendré utilise spécifiquement un argument différent de zéro pour appeler la routine exit . 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

Après avoir créé et exécuté un processus, chacune de ces fonctions passe un tableau de pointeurs à des arguments de ligne de commande et utilise la variable d'environnement PATH pour rechercher le fichier à exécuter.

Ces fonctions valident leurs paramètres. Si l’un cmdname 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

Processus et contrôle d’environnement
_spawn, fonctions _wspawn
abort
atexit
_exec, fonctions _wexec
exit, , _Exit_exit
_flushall
_getmbcp
_onexit, _onexit_m
_setmbcp
system, _wsystem