Funzione GetConsoleWindow

  • Articolo

Importante

Questo documento descrive le funzionalità della piattaforma della console che non fanno più parte della roadmap dell'ecosistema. Non è consigliabile usare questo contenuto nei nuovi prodotti, ma continueremo a supportare gli utilizzi esistenti per il futuro indefinito. La soluzione moderna preferita è incentrata sulle sequenze di terminale virtuale per garantire la massima compatibilità negli scenari multipiattaforma. Per altre informazioni su questa decisione di progettazione, vedere il documento relativo alla console classica e al terminale virtuale.

Recupera l'handle di finestra utilizzato dalla console associata al processo chiamante.

Sintassi

HWND WINAPI GetConsoleWindow(void);

Parametri

Questa funzione non ha parametri.

Valore restituito

Il valore restituito è un handle per la finestra utilizzata dalla console associata al processo chiamante o NULL se non esiste una console associata.

Osservazioni:

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Suggerimento

Questa API non è consigliata e non ha un terminale virtuale equivalente. Questa decisione allinea intenzionalmente la piattaforma Windows ad altri sistemi operativi. Questo stato è rilevante solo per l'utente, la sessione e il contesto dei privilegi locali. Le applicazioni remote tramite utilità multipiattaforma e trasporti come SSH potrebbero non funzionare come previsto se si usa questa API.

Per un'applicazione ospitata all'interno di una sessione pseudoconsole , questa funzione restituisce un handle di finestra solo a scopo di coda di messaggi. La finestra associata non viene visualizzata localmente perché la pseudoconsole serializza tutte le azioni in un flusso per la presentazione in un'altra finestra del terminale altrove.

Requisiti

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

Vedi anche

Funzioni della console