WriteConsole

WriteConsole

WriteConsole是一個Windows API函數。它用來從當前游標位置寫入一個字元串到屏幕緩衝區。

語法


BOOLWINAPIWriteConsole(
__in HANDLEhConsoleOutput,
__in const VOID *lpBuffer,
__in DWORDnNumberOfCharsToWrite,
__out LPDWORDlpNumberOfCharsWritten,
__reserved LPVOIDlpReserved);

參數


hConsoleOutput
控制台屏幕緩衝區的句柄。該句柄必須具有的GENERIC_WRITE的訪問許可權。
lpBuffer
包含要寫入控制台屏幕緩衝區字元的緩衝區的指針。
如果緩衝區的從進程的64kb堆里分配。緩衝區的最大大小將取決於堆的使用。
nNumberOfCharsToWrite
要寫入的字元數。如果指定的字元數的總大小超過可用的堆,該函數會ERROR_NOT_ENOUGH_MEMORY失敗。
lpNumberOfCharsWritten
指向接收實際寫入位元組數的變數指針。
lpReserved
Reserved; must be NULL.

返回值


如果函數成功,則返回值為非零值。
如果該函數失敗,則返回值為零。要獲取錯誤信息,請調用GetLastError

需求


客戶端需要Windows XP、Windows 2000 Professional、Windows NT Workstation、Windows MeWindows 98或者Windows 95
伺服器需要Windows Server 2003Windows 2000 Server或Windows NT Server。
頭文件在Wincon.h中聲明,包含於Windows.h。 
庫文件Kernel32.lib 
DLL需要Kernel32.dll。 
Unicode以 WriteConsoleW(Unicode) 和 WriteConsoleA(ANSI)的形式實現。