AllocConsole

小甲鱼

注：本文档由 百日维新 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

AllocConsole 函数用于为调用进程分配一个新的控制台。


API 函数原型：

BOOL WINAPI AllocConsole(void);

参数解析：

此函数没有任何参数。


返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。

若想获得更多的错误信息，请调用 GetLastError 函数。


备注：

1. 一个进程仅可以与一个控制台关联，如果调用 AllocConsole 函数的进程已经拥有一个关联的控制台，那么函数调用失败。进程可以使用 FreeConsole 函数解除当前控制台的关联，然后调用 AllocConsole 函数来创建一个新的控制台或者调用 AttachConsole 函数附加另一个控制台。

2. 如果调用进程创建子进程，则子进程继承新控制台。

3. AllocConsole 函数为新控制台初始化标准输入、标准输出和标准错误句柄。标准输入句柄为指向控制台的输入缓冲区句柄，标准输出句柄和标准错误句柄为指向控制台屏幕缓冲区句柄。可以使用 GetStdHandle 函数获取这些句柄。

4. 这个函数主要用于用户图形界面（GUI）应用程序创建一个控制台窗口。如果作为分离进程创建（以 DETACHED_PROCESS 参数值调用 CreateProcess 函数），则用户图形界面应用程序初始化无控制台关联，否则用户图形界面应用程序初始化都关联一个控制台。

（友情提示：在使用完控制台程序之后一定要记得调用 FreeConsole 函数释放该控制台，否则会造成内存泄露。）


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Wincon.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。