Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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’erreur étendues, appelez GetLastError.
Remarques
Un processus ne peut être associé qu’à une seule console, de sorte que la fonction AllocConsole échoue si le processus appelant a déjà une console. Un processus peut utiliser la fonction FreeConsole pour se détacher de sa console actuelle, puis appeler AllocConsole pour créer une console ou AttachConsole pour l’attacher à une autre console.
Si le processus appelant crée un processus enfant, l’enfant hérite de la nouvelle console.
AllocConsole initialise les handles d’entrée standard, de sortie standard et 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 utilisateur graphique (GUI) pour créer une fenêtre de console. Les applications GUI sont initialisées sans console. Les applications console sont initialisées avec 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 de page | ConsoleApi.h (via WinCon.h, incluez Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |