_execvpe, _wexecvpe
Lädt und neue untergeordnete Prozesse der Läufe.
Wichtig
Diese API kann nicht in Anwendungen verwendet werden, die im Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.
intptr_t _execvpe(
const char *cmdname,
const char *const *argv,
const char *const *envp
);
intptr_t _wexecvpe(
const wchar_t *cmdname,
const wchar_t *const *argv,
const wchar_t *const *envp
);
Parameter
cmdname
Pfad der auszuführenden Datei.argv
Array von Zeigern zu Parametern.envp
Array von Zeigern zu Umgebungseinstellungen.
Rückgabewert
Bei Erfolg kehren diese Funktionen nicht zum aufrufenden Prozess zurück. Ein Rückgabewert von - 1 gibt an, dass ein Fehler vorliegt; dann wird die globale Variable errno festgelegt.
errno-Wert |
Beschreibung |
---|---|
E2BIG |
Der Speicherplatz, der für die Argumente und die Umgebungseinstellungen erforderlich, als 32 KB. |
EACCES |
Für die angegebene Datei ist eine Sperr- oder Freigabeverletzung aufgetreten. |
EMFILE |
Zu viele Dateien geöffnet sind. (Die angegebene Datei muss geöffnet sein, um zu bestimmen, ob sie ausführbar ist.) |
ENOENT |
Die Datei oder der Pfad wurde nicht gefunden. |
ENOEXEC |
Die angegebene Datei ist nicht ausführbar oder hat ein ungültiges Format für eine ausführbare Datei. |
ENOMEM |
Nicht genügend Arbeitsspeicher zur Verfügung, den neuen Prozess auszuführen; der verfügbare Speicher ist beschädigt; oder ein ungültiger Block vorhanden ist, der angibt, dass der aufrufende Prozess nicht richtig zugeordnet wurde. |
Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.
Hinweise
Jede dieser Funktionen lädt und führt einen neuen Prozess aus und übergibt ein Array von Zeigern auf die Befehlszeilenargumente und ein Array von Zeigern auf den Umgebungseinstellungen. Diese Funktionen suchen die auszuführende Datei mithilfe der PATH-Umgebungsvariable.
Die _execvpe-Funktionen überprüfen ihre Parameter. Wenn cmdname ein NULL-Zeiger ist, oder wenn argv ein NULL-Zeiger, ein Zeiger auf ein leeres Array oder ein Zeiger auf ein Array handelt, das eine leere Zeichenfolge als Erstes Argument enthält, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, stellen diese Funktionen errno auf EINVAL ein und geben – 1 zurück. Es wird kein Prozess gestartet.
Anforderungen
Funktion |
Erforderlicher Header |
Optionaler Header |
---|---|---|
_execvpe |
<process.h> |
<errno.h> |
_wexecvpe |
<process.h> oder <wchar.h> |
<errno.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
Siehe das Beispiel in _exec- und _wexec-Funktionen.
.NET Framework-Entsprechung
Siehe auch
Referenz
Prozess- und Umgebungssteuerung