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.
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 |