WriteConsole是一個Windows API函式。它用來從當前游標位置寫入一個字元串到螢幕緩衝區。
基本介紹
- 中文名：WriteConsole
- 類別：程式函式
- DLL需求：Kernel32.dll
- 頭檔案：在Wincon.h中聲明含於Windows.h
語法,參數,返回值,需求,
語法
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 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)的形式實現。 |
