system, _wsystem
Führt einen Befehl 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.
int system(
const char *command
);
int _wsystem(
const wchar_t *command
);
Parameter
- command
Der Befehl, der ausgeführt werden soll.
Rückgabewert
Wenn commandNULL ist und der Befehlsinterpreter gefunden wird, gibt einen Wert ungleich 0 (null) zurück. Wenn der Befehlsinterpreter nicht gefunden wird, gibt 0 zurück und legt errno auf ENOENT fest. Wenn command nicht NULL ist, gibt system den Wert zurück, der vom Befehlsinterpreter zurückgegeben wird. Sie gibt den Wert 0 zurück, wenn der Befehlsinterpreter den Wert 0 zurückgibt. Bei dem Rückgabewert von 1 gibt einen Fehler an, und errno wird auf einen der folgenden Werte festgelegt:
E2BIG
Die Argumentliste (die anlagenspezifisch ist), ist zu groß.ENOENT
Der Befehlsinterpreter kann nicht gefunden werden.ENOEXEC
Die Befehlsinterpreterdatei kann nicht ausgeführt werden, da das Format ungültig ist.ENOMEM
Nicht genügend Speicher verfügbar, Befehl auszuführen; oder verfügbarer Speicher ist beschädigt; oder ein nicht-gültiger Block vorhanden ist, der angibt, dass der Prozess, der macht, der Aufruf nicht richtig zugeordnet wurde.
Siehe _doserrno, errno, _sys_errlist und _sys_nerr weitere Informationen zu diesen Rückgabecodes.
Hinweise
Die Funktion system führt command den Befehlsinterpreter, der die Zeichenfolge als Betriebssystembefehl ausführt. system verwendet die COMSPEC und PATH, um die Umgebungsvariablen Befehlsinterpreterdatei CMD.exe zu suchen. Wenn commandNULL ist, überprüft die Funktion nur, ob der Befehlsinterpreter vorhanden ist.
Sie müssen explizit Leeren-durch die Anwendung von fflush oder von Abschluss _flushall- oder einer beliebigen Stream, bevor Sie system aufrufen.
_wsystem ist eine Breitzeichenversion von system. Das command-Argument für _wsystem ist eine Breitzeichenfolge. Anderenfalls verhalten sich diese Funktionen identisch.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_tsystem |
system |
system |
_wsystem |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
system |
<process.h> oder <stdlib.h> |
_wsystem |
<process.h oder> stdlib.h <oder wchar.h> <> |
Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
In diesem Beispiel wird system, um eine Textdatei EINZUGEBEN.
// crt_system.c
#include <process.h>
int main( void )
{
system( "type crt_system.txt" );
}
Eingabe: crt_system.txt
Line one.
Line two.
Ausgabe
Line one.
Line two.