Fonction AllocConsole

Article
07/12/2023

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