Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

_spawnl, _wspawnl

Visual Studio 2012

Autres versions

Crée et exécute un nouveau processus.

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 _spawnl(
   int mode,
   const char *cmdname,
   const char *arg0,
   const char *arg1,
   ... const char *argn,
   NULL 
);
intptr_t _wspawnl(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *arg0,
   const wchar_t *arg1,
   ... const wchar_t *argn,
   NULL 
);

Paramètres

mode: Mode d'exécution du processus appelant.
cmdname: Chemin d'accès du fichier à exécuter.
arg0, arg1, ... argn: Liste des pointeurs vers des arguments. L'argument d' arg0 est généralement un pointeur vers cmdname. Les arguments arg1 via argn sont des pointeurs vers des chaînes de caractères signe plus la nouvelle liste d'arguments. Après argn, il doit exister un pointeur d' NULL pour marquer la fin de la liste d'arguments.

Valeur de retour

La valeur de retour d' _spawnl synchrone ou d' _wspawnl (_P_WAIT spécifié pour mode) est l'état de sortie du nouveau processus. La valeur de retour d' _spawnl asynchrone ou d' _wspawnl (_P_NOWAIT ou _P_NOWAITO spécifié pour mode) est le handle de processus. L'état de sortie est 0 si le processus s'terminait 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 d' exit avec un argument différent de zéro. Si le nouveau processus ne plaçait pas explicitement un rapport de sortie positif, un rapport de sortie positif indique une sortie anormale avec un arrêt ou une interruption. Une valeur de retour à 1 indique une erreur (le nouveau processus n'est pas lancé). Dans ce cas, errno a une des valeurs suivantes.

E2BIG: La liste d'arguments dépasse 1024 octets.
EINVAL: l'argument d'mode est incorrect.
ENOENT: Le fichier ou le chemin d'accès est introuvable.
ENOEXEC: Le fichier spécifié n'est pas exécutable ou a le format de fichier exécutable non valide.
ENOMEM: Mémoire insuffisante est disponible pour exécuter le nouveau processus.

Pour plus d'informations sur ces derniers et d'autres codes de retour, consultez l' _doserrno, errno, _sys_errlist, et _sys_nerr.

Ces fonctions valident leurs paramètres. Si cmdname ou arg0 est une chaîne vide ou un pointeur null, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres. Si est autorisé à l'exécution pour continuer, ces fonctions par errno définir le retour à EINVAL, et -1. Aucun nouveau processus n'a engendré.