Función AllocConsole

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.

Observaciones

Un proceso solo se puede asociar 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 separarse de su consola actual y, a continuación, puede llamar a AllocConsole para crear una nueva consola o AttachConsole para asociarla 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 la usa principalmente una aplicación gráfica de interfaz 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]
Cabecera	ConsoleApi.h (a través de WinCon.h, incluye Windows.h)
Biblioteca	Kernel32.lib
Archivo DLL	Kernel32.dll

Consulte también

Funciones de consola

Consolas

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle