system, _wsystem

Článek
06/09/2015

Spustí příkaz.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v prostředí Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

int system(
   const char *command 
);
int _wsystem(
   const wchar_t *command 
);

Parametry

command
Příkaz, který má být proveden.

Vrácená hodnota

Pokud command je NULL a interpretu příkazů je nalezen, vrátí nenulovou hodnotu.Pokud překladač příkazů není nalezen, vrátí hodnotu 0 a nastaví errno na ENOENT.Pokud command není NULL, system vrátí hodnotu, která je vrácena pomocí překladače příkazů.Vrátí hodnotu 0, pouze v případě, že překladač příkazů, vrátí hodnotu 0.Vrácená hodnota-1 označuje chybu, a errno je nastavena na jednu z následujících hodnot:

E2BIG
V seznamu argumentů (což je závislé na systému) je příliš velký.
ENOENT
Překladač příkazů nebyl nalezen.
ENOEXEC
Překladač příkazů souboru nelze provést, protože formát není platný.
ENOMEM
Není dostatek paměti je k dispozici pro spuštění příkazu; nebo byla poškozena paměť; nebo neplatné blok existuje, což znamená, že proces, který je volání nebyl správně přidělen.

Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto návratových kódů.

Poznámky

system Fungovat průchodů command k interpretu příkazů, které spustí řetězec jako příkaz aplikace operačního systému.systempoužívá COMSPEC a PATH soubor proměnných prostředí, přejděte na příkaz interpretu příkazů CMD.exe.Pokud command je NULL, funkce pouze kontroluje, zda existuje interpretu příkazů.

Musíte explicitně vyprázdnění – pomocí fflush nebo _flushall– nebo zavřít všechny datového proudu před voláním system.

_wsystemje verzí širokého znaku system; command argument _wsystem je řetězec širokého znaku.Tyto funkce chovat identicky jinak.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tsystem	system	system	_wsystem

Požadavky

Byla zahájena rutina	Požadované záhlaví
system	<process.h> nebo <stdlib.h>
_wsystem	<process.h> nebo <stdlib.h> nebo <wchar.h>

Další informace o kompatibilitě, viz Kompatibilita.

Příklad

V tomto příkladu system zadejte do textového souboru.

// crt_system.c

#include <process.h>

int main( void )
{
   system( "type crt_system.txt" );
}

Vstup: crt_system.txt

Line one.
Line two.

Výsledek

Line one.
Line two.

Ekvivalent v rozhraní .NET Framework

Viz také

Referenční dokumentace

Řízení procesů a prostředí

_exec, _wexec – funkce

exit, _exit

_flushall

_spawn, _wspawn – funkce

Sdílet prostřednictvím