AllocConsoleWithOptions işlevi

İsteğe bağlı olarak, arama işlemi için yeni bir konsol ayırır ve yeni konsol penceresinin görünürlüğünü belirtmenize olanak sağlar.

Sözdizimi

HRESULT WINAPI AllocConsoleWithOptions(
    _In_opt_  PALLOC_CONSOLE_OPTIONS allocOptions,
    _Out_opt_ PALLOC_CONSOLE_RESULT  result
);

Parametreler

allocOptions [in, isteğe bağlı] Bu işlevin bir pencereyi nasıl ayırdığını denetleen bir ALLOC_CONSOLE_OPTIONS yapısı.

result [out, optional] Aşağıdaki değerlerden birini alır:

Değer	Anlamı
ALLOC_CONSOLE_RESULT_NO_CONSOLE 0	ALLOC_CONSOLE_MODE_DEFAULT kullanıldığı ve üst işlemin oluşturulmamasını istediği için konsol oluşturulmadı.
ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1	Bu çağrının sonucu olarak yeni bir konsol oturumu oluşturuldu. Sonuçta elde edilen davranış AllocConsole ile aynıdır.
ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2	İşlem, üst işlem tarafından devralınan mevcut bir konsol oturumuna kendini bağlamıştır. Sonuçta elde edilen davranış AttachConsole ile aynıdır.

Dönüş değeri

Tür: HRESULT

Bu yöntem başarılı olursa, S_OKdöndürür. Aksi takdirde, bir HRESULT hata kodu döndürür.

Açıklamalar

AllocConsole veya AttachConsole'un aksine, konsol oturumuna zaten bağlıyken bu yöntemin çağrılması hataya neden olmaz. Sonuç parametresibu durumda ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE olarak ayarlanır.

Bir işlem, kendisini geçerli konsolundan ayırmak için FreeConsole işlevini kullanabilir. Bir konsola eklenen son işlem sonlandırıldığında veya FreeConsole'yi çağırdığında kapatılır.

Gereksinimler

Desteklenen en düşük düzeydeki istemci	Windows 11 24H2 (derleme 26100) [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu	Windows Server 2025 (derleme 26100)
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ı

Konsol Ayırma İlkesi

AllocConsole

AttachConsole

FreeConsole