AllocConsole işlevi

Arama işlemi için yeni bir konsol ayırır.

Sözdizimi

BOOL WINAPI AllocConsole(void);

Parametreler

Bu işlevin parametresi yok.

Dönüş değeri

İşlev başarılı olursa, dönüş değeri sıfır değildir.

İşlev başarısız olursa, dönüş değeri sıfır olur. Genişletilmiş hata bilgilerini almak için GetLastError'ı arayın.

Açıklamalar

Bir işlem yalnızca bir konsolla ilişkilendirilebilir, bu nedenle çağrı işleminin zaten bir konsolu varsa AllocConsole işlevi başarısız olur. Bir işlem FreeConsole işlevini kullanarak kendisini geçerli konsolundan ayırabilir, ardından AllocConsole'u çağırarak yeni bir konsol oluşturabilir veya Başka bir konsola eklemek için AttachConsole'u çağırabilir.

Çağıran işlem bir alt işlem oluşturursa, alt işlem yeni konsolu devralır.

AllocConsole yeni konsol için standart girişi, standart çıkışı ve standart hata tanıtıcılarını başlatır. Standart giriş tutamacı konsolun giriş arabelleğinin tutamacıdır ve standart çıkış ve standart hata tutamaçları konsolun ekran arabelleğinin tutamaçlarıdır. Bu tanıtıcıları almak için GetStdHandle işlevini kullanın.

Bu işlev öncelikli olarak bir grafik kullanıcı arabirimi (GUI) uygulaması tarafından konsol penceresi oluşturmak için kullanılır. GUI uygulamaları konsol olmadan başlatılır. Konsol uygulamaları, ayrılmış işlemler olarak oluşturulmadıkları sürece (DETACHED_PROCESS bayrağıyla CreateProcess işlevini çağırarak) bir konsol ile başlatılır.

Gereksinimler

Desteklenen en düşük düzeydeki istemci	Windows 2000 Professional [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu	Windows 2000 Server [yalnızca masaüstü uygulamaları]
Başlık	ConsoleApi.h (WinCon.h aracılığıyla Windows.h'yi dahil edin)
Kütüphane	Kernel32.lib
DLL	Kernel32.dll

Ayrıca bakınız

Konsol İşlevleri

Konsolları

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle