Funzione AllocConsoleWithOptions

Opzionalmente alloca una nuova console per il processo chiamante, consentendo di definire la visibilità della nuova finestra della console.

Sintassi

HRESULT WINAPI AllocConsoleWithOptions(
    _In_opt_  PALLOC_CONSOLE_OPTIONS allocOptions,
    _Out_opt_ PALLOC_CONSOLE_RESULT  result
);

Parametri

allocOptions [in, facoltativo] Struttura ALLOC_CONSOLE_OPTIONS che controlla la modalità di allocazione di una finestra da parte di questa funzione.

result [out, facoltativo] Riceve uno dei valori seguenti:

Valore	Significato
ALLOC_CONSOLE_RESULT_NO_CONSOLE 0	Non è stata creata alcuna console, perché è stato usato ALLOC_CONSOLE_MODE_DEFAULT e il processo padre ha chiesto di non crearne alcuna.
ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1	Una nuova sessione della console è stata creata in seguito a questa chiamata. Il comportamento risultante è identico a AllocConsole.
ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2	Il processo si è collegato a una sessione della console esistente, ereditata dal processo padre. Il comportamento risultante è identico a AttachConsole.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni:

A differenza di AllocConsole o AttachConsole, la chiamata a questo metodo quando è già connessa a una sessione della console non genera un errore. Il parametro del risultato verrà impostato su ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE in tal caso.

Un processo può usare la funzione FreeConsole per scollegarsi dalla console corrente. Una console viene chiusa quando l'ultimo processo collegato termina o chiama FreeConsole.

Requisiti

Client minimo supportato	Windows 11 24H2 (build 26100) [solo applicazioni desktop]
Server minimo supportato	Windows Server 2025 (build 26100)
Intestazione	ConsoleApi.h (tramite WinCon.h, includere Windows.h)
Libreria	kernel32.lib
DLL	Kernel32.dll

Vedere anche

Funzioni della console

console di

Criteri di allocazione della console

AllocConsole

AttachConsole

FreeConsole