Función AllocConsole

Artículo
07/12/2023

Asigna una nueva consola para el proceso de llamada.

Sintaxis

BOOL WINAPI AllocConsole(void);

Parámetros

Esta función no tiene parámetros.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Un proceso se puede asociar solo a una consola, por lo que se produce un error en la función AllocConsole si el proceso de llamada ya tiene una consola. Un proceso puede usar la función FreeConsole para desasociarse de su consola actual y, después, puede llamar a AllocConsole para crear una nueva consola o AttachConsole para asociarse a otra consola.

Si el proceso de llamada crea un proceso secundario, el elemento secundario hereda la nueva consola.

AllocConsole inicializa la entrada estándar, la salida estándar y los identificadores de error estándar para la nueva consola. El identificador de entrada estándar es un identificador del búfer de entrada de la consola, y los identificadores de salida estándar y de error estándar son identificadores del búfer de pantalla de la consola. Para recuperar estos identificadores, use la función GetStdHandle.

Esta función se usa principalmente en una aplicación de interfaz gráfica de usuario (GUI) para crear una ventana de consola. Las aplicaciones de GUI se inicializan sin una consola. Las aplicaciones de consola se inicializan con una consola, a menos que se creen como procesos desasociados (llamando a la función CreateProcess con la marca DETACHED_PROCESS).

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	ConsoleApi.h (a través de WinCon.h, incluido Windows.h)
Biblioteca	Kernel32.lib
Archivo DLL	Kernel32.dll