WriteConsole是一个Windows API函数。它用来从当前光标位置写入一个字符串到屏幕缓冲区。

语法

BOOL

WINAPIWriteConsole(

__in

HANDLE

hConsoleOutput,

__in

const VOID *

lpBuffer,

__in

DWORD

nNumberOfCharsToWrite,

__out

LPDWORD

lpNumberOfCharsWritten,

__reserved

LPVOID

lpReserved);[1]

参数

hConsoleOutput

控制台屏幕缓冲区的句柄。该句柄必须具有的GENERIC_WRITE的访问权限。

lpBuffer

包含要写入控制台屏幕缓冲区字符的缓冲区的指针。

如果缓冲区的从进程的64kb堆里分配。缓冲区的最大大小将取决于堆的使用。

nNumberOfCharsToWrite

要写入的字符数。如果指定的字符数的总大小超过可用的堆，该函数会ERROR_NOT_ENOUGH_MEMORY失败。

lpNumberOfCharsWritten

指向接收实际写入字节数的变量指针。

lpReserved

Reserved; must be NULL.[1]

返回值

如果函数成功，则返回值为非零值。

如果该函数失败，则返回值为零。要获取错误信息，请调用GetLastError。[1]

需求

客户端

需要Windows XP、Windows 2000 Professional、Windows NT Workstation、Windows Me、Windows 98或者Windows 95。

服务器

需要Windows Server 2003、Windows 2000 Server或Windows NT Server。

头文件

在Wincon.h中声明，包含于Windows.h。 
库文件Kernel32.lib 

DLL

需要Kernel32.dll。 

Unicode

以

WriteConsoleW

(Unicode) 和

WriteConsoleA

(ANSI)的形式实现。