Fonction AllocConsole
Alloue une nouvelle console pour le processus appelant.
Syntaxe
BOOL WINAPI AllocConsole(void);
Paramètres
Cette fonction n’a pas de paramètres.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
Un processus peut être associé à une seule console. Par conséquent, la fonction AllocConsole échoue si le processus appelant dispose déjà d’une console. Un processus peut utiliser la fonction FreeConsole pour se détacher de sa console actuelle, puis appeler AllocConsole pour créer une nouvelle console ou AttachConsole pour effectuer l’attachement à une autre console.
Si le processus appelant crée un processus enfant, l’enfant hérite de la nouvelle console.
AllocConsole Initialise une entrée standard, une sortie standard et des handles d’erreur standard pour la nouvelle console. Le handle d’entrée standard est un handle vers la mémoire tampon d’entrée de la console, et les handles de sortie standard et d’erreur standard sont des handles vers la mémoire tampon d’écran de la console. Pour récupérer ces handles, utilisez la fonction GetStdHandle.
Cette fonction est principalement utilisée par une application d’interface graphique utilisateur (GUI) pour créer une fenêtre de console. Les applications GUI sont initialisées sans console. Les applications console sont initialisées à l’aide d’une console, sauf si elles sont créées en tant que processus détachés (en appelant la fonction CreateProcess avec l’indicateur DETACHED_PROCESS).
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 | ConsoleApi.h (via WinCon.h, inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |