Fungsi AllocConsole

Artikel
10/20/2023

Mengalokasikan konsol baru untuk proses panggilan.

Sintaks

BOOL WINAPI AllocConsole(void);

Parameter

Fungsi ini tidak memiliki parameter.

Nilai hasil

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Proses hanya dapat dikaitkan dengan satu konsol, sehingga fungsi AllocConsole gagal jika proses panggilan sudah memiliki konsol. Proses dapat menggunakan fungsi FreeConsole untuk melepaskan dirinya dari konsolnya saat ini, kemudian dapat memanggil AllocConsole untuk membuat konsol baru atau AttachConsole untuk melampirkan ke konsol lain.

Jika proses panggilan membuat proses anak, anak akan mewarisi konsol baru.

AllocConsole menginisialisasi input standar, output standar, dan handel kesalahan standar untuk konsol baru. Handel input standar adalah handel ke buffer input konsol, dan output standar dan handel kesalahan standar ditangani ke buffer layar konsol. Untuk mengambil handel ini, gunakan fungsi GetStdHandle.

Fungsi ini terutama digunakan oleh aplikasi antarmuka pengguna grafis (GUI) untuk membuat jendela konsol. Aplikasi GUI diinisialisasi tanpa konsol. Aplikasi konsol diinisialisasi dengan konsol, kecuali dibuat sebagai proses yang dilepas (dengan memanggil fungsi CreateProcess dengan bendera DETACHED_PROCESS).

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	ConsoleApi.h (melalui WinCon.h, sertakan Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll