system, _wsystem

Bir komut yürütür.

Önemli

Bu API, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.

Sözdizimi

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

Parametreler

command
Yürütülecek komut.

Dönüş değeri

NULL ise ve komut yorumlayıcısı bulunursa command sıfır olmayan bir değer döndürür. Komut yorumlayıcısı bulunamazsa, 0 döndürür ve olarak ENOENTayarlarerrno. değilse command NULL, system komut yorumlayıcısı tarafından döndürülen değeri döndürür. Yalnızca komut yorumlayıcısı 0 değerini döndürürse 0 değerini döndürür. -1 dönüş değeri bir hatayı gösterir ve errno aşağıdaki değerlerden birine ayarlanır:

Value	Açıklama
E2BIG	Bağımsız değişken listesi (sisteme bağımlıdır) çok büyük.
ENOENT	Komut yorumlayıcısı bulunamıyor.
ENOEXEC	Biçim geçerli olmadığından komut yorumlayıcı dosyası yürütülemiyor.
ENOMEM	Komutu yürütmek için yeterli bellek yok; veya kullanılabilir bellek bozulmuş; veya çağırma işleminin yanlış ayrıldığını gösteren geçerli olmayan bir blok var.

İade kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

İşlev system , dizeyi bir işletim sistemi komutu olarak yürüten komut yorumlayıcısına geçer command . systemCOMSPEC komut yorumlayıcı dosyasını bulmak için ve PATH ortam değişkenlerini CMD.exe. ise command NULL, işlev yalnızca komut yorumlayıcının var olup olmadığını denetler.

veya kullanarak fflush _flushallaçıkça temizlemeniz veya çağırmadan systemönce herhangi bir akışı kapatmanız gerekir.

_wsystem , öğesinin systemgeniş karakterli bir sürümüdür; command bağımsız değişkeni _wsystem geniş karakterli bir dizedir. Bu işlevler aynı şekilde davranır.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H olağan	_UNICODE ve _MBCS tanımlanmadı	_MBCS tanımlanan	_UNICODE tanımlanan
_tsystem	system	system	_wsystem

Gereksinimler

Yordam	Gerekli başlık
system	<process.h> veya <stdlib.h>
_wsystem	<process.h>veya veya <stdlib.h><wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

Bu örnek, bir metin dosyası YAZMAK için kullanır system .

// crt_system.c

#include <process.h>

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

Giriş: crt_system.txt

Line one.
Line two.

Çıktı

Line one.
Line two.

Ayrıca bkz.

İşlem ve ortam denetimi
_exec, _wexec işlevler
exit, _Exit, _exit
_flushall
_spawn, _wspawn işlevler