Fungsi AllocConsole

Mengalokasikan konsol baru untuk proses panggilan.

Sintaksis

BOOL WINAPI AllocConsole(void);

Parameter-parameternya

Fungsi ini tidak memiliki parameter.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Komentar

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. Handle input standar adalah handle ke buffer input konsol, dan handle output standar serta handle error standar adalah handle ke buffer layar konsol. Untuk mengambil handle 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]
Kepala Halaman	ConsoleApi.h (melalui WinCon.h, sertakan Windows.h)
Perpustakaan	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Fungsi Konsol

Konsol

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle