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)所有,转载请注明来源。
页:
[1]