Fungsi AllocConsoleWithOptions

Secara opsional mengalokasikan konsol baru untuk proses panggilan, sambil memungkinkan Anda menentukan visibilitas jendela konsol baru.

Sintaksis

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

Parameter-parameternya

allocOptions [in, opsional] Struktur ALLOC_CONSOLE_OPTIONS yang mengontrol bagaimana fungsi ini mengalokasikan jendela.

result [out, opsional] Menerima salah satu nilai berikut:

Nilai	Makna
ALLOC_CONSOLE_RESULT_NO_CONSOLE 0	Tidak ada konsol yang dibuat, karena ALLOC_CONSOLE_MODE_DEFAULT digunakan dan proses induk meminta tidak ada yang dibuat.
ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1	Sesi konsol baru dibuat sebagai akibat dari panggilan ini. Perilaku yang dihasilkan identik dengan AllocConsole.
ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2	Proses ini telah terlampir ke sesi konsol aktif, yang diwarisi dari proses induk. Perilaku yang dihasilkan identik dengan AttachConsole.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT.

Komentar

Tidak seperti AllocConsole atau AttachConsole, memanggil metode ini ketika sudah tersambung ke sesi konsol tidak mengakibatkan kesalahan. Parameter hasil akan diatur ke ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE dalam kasus tersebut.

Proses dapat menggunakan fungsi FreeConsole untuk melepaskan dirinya dari konsolnya saat ini. Konsol ditutup ketika proses terakhir yang dilampirkan ke konsol berakhir atau memanggil FreeConsole.

Persyaratan

Klien minimum yang didukung	Windows 11 24H2 (build 26100) [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2025 (build 26100)
Kepala Halaman	ConsoleApi.h (melalui WinCon.h, sertakan Windows.h)
Perpustakaan	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Fungsi Konsol

Konsol

Kebijakan Alokasi Konsol

AllocConsole

AttachConsole

FreeConsole