Sdílet prostřednictvím


system, _wsystem

Spustí příkaz.

Důležitá poznámkaDů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