Fonction GetConsoleWindow
Important
Ce document décrit les fonctionnalités de la plateforme de la console qui ne font plus partie de la feuille de route de notre écosystème. Nous vous déconseillons d’utiliser ce contenu dans de nouveaux produits, mais nous continuerons à prendre en charge des utilisations existantes pour l’avenir indéterminé. Notre solution moderne préférée se concentre sur les séquences de terminaux virtuels pour une compatibilité maximale dans les scénarios multiplateformes. Vous trouverez plus d’informations sur cette décision de conception dans notre document sur les consoles classiques et les terminaux virtuels.
Récupère le descripteur de fenêtre utilisé par la console associée au processus appelant.
Syntaxe
HWND WINAPI GetConsoleWindow(void);
Paramètres
Cette fonction n’a pas de paramètres.
Valeur renvoyée
La valeur renvoyée est un descripteur vers la fenêtre utilisée par la console associée au processus appelant ou NUL s’il n’existe aucune console associée.
Notes
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT sur 0x0500 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.
Conseil
Cette API n’est pas recommandée et n’a pas d’équivalent de terminal virtuel. Cette décision aligne intentionnellement la plateforme Windows avec d’autres systèmes d’exploitation. Cet état n'est pertinent que pour l'utilisateur local, la session et le contexte des privilèges. La communication à distance des applications via des utilitaires multiplateformes et des transports comme SSH peut ne pas fonctionner comme prévu si vous utilisez cette API.
Pour une application hébergée à l’intérieur d’une session pseudoconsole, cette fonction renvoie un descripteur de fenêtre uniquement à des fins de file d’attente de messages. La fenêtre associée n'est pas affichée localement car la pseudoconsole sérialise toutes les actions dans un flux pour les présenter dans une autre fenêtre de terminal.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | ConsoleApi3.h (via WinCon.h, include Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |