AllocConsole (funzione)

Articolo
07/12/2023

Alloca una nuova console per il processo chiamante.

Sintassi

BOOL WINAPI AllocConsole(void);

Parametri

Questa funzione non ha parametri.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni:

Un processo può essere associato a una sola console, quindi la funzione AllocConsole ha esito negativo se il processo chiamante dispone già di una console. Un processo può utilizzare la funzione FreeConsole per scollegarsi dalla console corrente e successivamente chiamare la funzione AllocConsole per creare una nuova console o AttachConsole per connettersi a un'altra console.

Se il processo chiamante crea un processo figlio, l'elemento figlio eredita la nuova console.

La funzione AllocConsole inizializza l'input standard, l'output standard e gli handle di errore standard per la nuova console. L'handle di input standard è un handle per il buffer di input della console, gli handle di output standard e di errore standard sono handle per il buffer dello schermo della console. Per recuperare questi handle usare la funzione GetStdHandle.

Questa funzione viene utilizzata principalmente da un'applicazione interfaccia utente grafica (GUI) per creare una finestra della console. Le applicazioni GUI vengono inizializzate senza una console. Le applicazioni console vengono inizializzate con una console, a meno che non vengano create come processi scollegati (chiamando la funzione CreateProcess con il flag DETACHED_PROCESS).

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ConsoleApi.h (tramite WinCon.h, con Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll