_execle, _wexecle

Artikel
06/09/2015

Lädt neue untergeordnete Prozesse und führt sie aus.

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 _execle( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexecle( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const char *const *envp 
);

Parameter

cmdname
Pfad der auszuführenden Datei.
arg0, ...argn
Liste 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.
EINVAL	Ungültiger Parameter.
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 über diese 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 und führt jede Befehlszeilenargument als separater Parameter und übergibt ein Array von Zeigern auf den Umgebungseinstellungen.

Die _execle-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 weitere Ausführung zugelassen wird, stellen diese Funktionen errno auf EINVAL ein und geben – 1 zurück. Es wird kein neuer Prozess gestartet.