Funzione AllocConsole

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 ottenere informazioni estese 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 ha già una console. Un processo può usare la funzione FreeConsole per scollegarsi dalla console corrente, quindi può chiamare AllocConsole per creare una nuova console o AttachConsole per collegarsi a un'altra console.

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

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

Questa funzione viene usata principalmente da un'applicazione grafica dell'interfaccia utente (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

Vedere anche

Funzioni della console

console di

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle