_spawnvpe, _wspawnvpe

Erstellt einen neuen Prozess und führt ihn aus.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

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
);

Parameter

mode
Ausführungsmodus für einen aufrufenden Prozess

cmdname
Pfad der auszuführenden Datei

argv
Array von Zeigern zu Argumenten. Das Argument argv[0] ist in der Regel ein Zeiger auf einen Pfad im realen Modus oder auf den Programmnamen im geschützten Modus, und argv[1]argv[n] durch die Zeiger auf die Zeichenzeichenfolgen, die die neue Argumentliste bilden. Das Argument argv[n+1] muss ein NULL Zeiger sein, um das Ende der Argumentliste zu markieren.

envp
Array von Zeigern zu Umgebungseinstellungen

Rückgabewert

Der Rückgabewert eines synchronen _spawnvpe oder _wspawnvpe (_P_WAIT angegeben für mode) ist der Beendigungsstatus des neuen Prozesses. Der Rückgabewert eines asynchronen _spawnvpe oder _wspawnvpe (_P_NOWAIT oder _P_NOWAITO angegeben für mode) ist das Prozesshandle. Der Beendigungsstatus ist 0, wenn der Prozess ordnungsgemäß beendet wurde. Sie können den Beendigungsstatus auf einen Wert ungleich 0 einstellen, wenn der gestartete Prozess speziell die exit -Routine mit einem Argument ungleich 0 aufruft. Wenn der neue Prozess keinen positiven Beendigungsstatus explizit festgelegt hat, gibt ein positiver Beendigungsstatus einen abnormen Ausgang mit einem Abbruch oder einem Interrupt an. Ein Rückgabewert von -1 gibt einen Fehler an (der neue Prozess wird nicht gestartet). In diesem Fall wird errno auf einen der folgenden Werte festgelegt:

Wert	Beschreibung
E2BIG	Argumentliste umfasst mehr als 1024 Byte.
EINVAL	mode -Argument ist ungültig.
ENOENT	Datei oder Pfad wurde nicht gefunden.
ENOEXEC	Die angegebene Datei ist nicht ausführbar oder weist ein ungültiges Dateiformat für ausführbare Dateien auf.
ENOMEM	Es ist nicht genügend Arbeitsspeicher verfügbar, um den neuen Prozess auszuführen.

Weitere Informationen zu Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Jede dieser Funktionen erstellt einen neuen Prozess, führt diesen aus und übergibt ein Array von Zeigern auf Befehlszeilenargumente und ein Array von Zeigern auf die Umgebungseinstellungen. Diese Funktionen suchen die auszuführende Datei mithilfe der PATH-Umgebungsvariable.

Diese Funktionen überprüfen ihre Parameter. Wenn es sich um cmdname einen Nullzeiger oder argv um einen Nullzeiger handelt oder argvargv[0] eine leere Zeichenfolge ist, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, stellen diese Funktionen errno auf EINVALein und geben – 1 zurück. Es wird kein neuer Prozess erzeugt.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Routine	Erforderlicher Header
_spawnvpe	<stdio.h> oder <process.h>
_wspawnvpe	<stdio.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

Sehen Sie sich das Beispiel in _spawn, _wspawn Funktionen an.

Siehe auch

abort
atexit
_exec, _wexec Funktionen
exit, _Exit, _exit
_flushall
_getmbcp
_onexit, _onexit_m
_setmbcp
system, _wsystem