_execvpe, _wexecvpe

Artikel
02/26/2013

Lädt und neue untergeordnete Prozesse der Ausführungen.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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 Datei auszuführen.
argv
Array von Zeigern auf Parameter.
envp
Array von Zeigern auf den Umgebungseinstellungen.

Rückgabewert

Wenn erfolgreich, geben diese Funktionen nicht an den aufrufenden Prozess zurück.Ein Rückgabewert von - 1 gibt einen Fehler an, in diesem Fall die globale Variable errno festgelegt ist.

errno-Wert	Beschreibung
E2BIG	Der Speicherplatz, der für die Argumente und die Umgebungseinstellungen erforderlich ist, als 32 KB.
EACCES	Die angegebene Datei ist eine Sperre oder eine Zugriffsverletzung.
EMFILE	Zu viele Dateien geöffnet sind.(Die angegebene Datei muss geöffnet sein, um zu bestimmen, ob sie ausgeführt werden kann).
ENOENT	Die Datei oder wird der Pfad nicht gefunden.
ENOEXEC	Die angegebene Datei ist nicht ausführbar oder hat ein ungültiges Format der ausführbaren Datei.
ENOMEM	Nicht genügend Arbeitsspeicher verfügbar ist, den neuen Prozess auszuführen; der verfügbare Arbeitsspeicher ist beschädigt; oder ein ungültiger Block vorhanden ist, der angibt, dass der aufrufende Prozess nicht ordnungsgemäß 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 führt ein Array von Zeigern auf den Befehlszeilenargumenten und ein Array von Zeigern auf den Umgebungseinstellungen.Diese Funktionen verwenden die PATH Umgebungsvariable, um die Datei zu suchen, um.

Die _execvpe-Funktionen überprüfen ihre Parameter.Wenn cmdname ein NULL-Zeiger ist, oder wenn argv ein NULL-Zeiger, ein Zeiger auf einen leeren Array oder ein Zeiger auf ein Array ist, das eine leere Zeichenfolge als Erstes Argument enthält, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, dieses Funktionen festgelegte errno zu EINVAL und zu geben -1.Kein Prozess gestartet.