Fungsi AllocConsole
Mengalokasikan konsol baru untuk proses panggilan.
BOOL WINAPI AllocConsole(void);
Fungsi ini tidak memiliki parameter.
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
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).
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 |