_execlp, _wexeclp
Lädt und führt neue untergeordnete Prozesse aus.
Wichtig |
---|
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW. |
intptr_t _execlp( const char *cmdname, const char *arg0, ... const char *argn, NULL ); intptr_t _wexeclp( const wchar_t *cmdname, const wchar_t *arg0, ... const wchar_t *argn, NULL );
Parameter
cmdname
Pfad der Datei auszuführen.arg0, ...argn
Liste von Zeigern Parameter an.
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 benötigt wird, als 32 KB. |
EACCES |
Die angegebene Datei ist eine Sperre oder eine Zugriffsverletzung. |
EINVAL |
Ungültiger Parameter. |
EMFILE |
Zu viele Dateien geöffnet (die angegebene Datei muss geöffnet sein, um zu bestimmen, ob sie ausgeführt werden kann). |
ENOENT |
Die Datei oder 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 und angibt, dass der aufrufende Prozess nicht ordnungsgemäß zugeordnet wurde. |
Weitere Informationen zu diesen und anderen Rückgabecodes, finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Jede dieser Funktionen lädt und führt einen neuen Prozess aus, übergibt jedes Befehlszeilenargument als separater Parameter und verwendet die PATH Umgebungsvariable, um die Datei zu suchen, um.
Die _execlp-Funktionen überprüfen ihre Parameter.Wenn cmdname oder arg0 ein NULL-Zeiger oder eine leere Zeichenfolge ist, 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 neuer Prozess gestartet.
Anforderungen
Funktion |
Erforderlicher Header |
Optionaler Header |
---|---|---|
_execlp |
<process.h> |
<errno.h> |
_wexeclp |
<process.h> oder <wchar.h> |
<errno.h> |
Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.
Beispiel
Im Beispiel in _exec, _wexec Funktionen.