Freigeben über


System, _wsystem

Führt einen Befehl aus.

Wichtiger HinweisWichtig

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.

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 zu 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.Ein 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 Arbeitsspeicher verfügbar ist, Befehl auszuführen; oder verfügbarer Speicher ist beschädigt; oder ein nicht-gültiger Block vorhanden ist, der angibt, dass der Prozess, der ausführt, der Aufruf nicht ordnungsgemäß zugeordnet wurde.

Siehe _doserrno, errno, _sys_errlist und _sys_nerr weitere Informationen zu diesen Rückgabecodes.

Hinweise

Die system-Funktion führt command den Befehlsinterpreter, der die Zeichenfolge als Betriebssystembefehl ausgeführt wird.system verwendet die COMSPEC und PATH Umgebungsvariablen, um die 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 _flushall- oder jeden Stream zu schließen, bevor Sie system aufrufen.

_wsystem ist eine Breitzeichen-Version von system; command das Argument an _wsystem ist eine Zeichenfolge mit Breitzeichen.Diese Funktionen verhalten sich andernfalls identisch.

Zuordnung generische 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>

So zusätzlicher Kompatibilitätsinformation 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.

277bwbdz.collapse_all(de-de,VS.110).gifAusgabe

Line one.
Line two.

.NET Framework-Entsprechung

Siehe auch

Referenz

Prozess- und Umgebungssteuerelement

_exec, _wexec Funktionen

Beenden, _exit

_flushall

_spawn, _wspawn Funktionen