函数 WriteFile 用输出句柄向文件写入数据。句柄可以是屏幕缓冲区句柄,也可以是分配给文本文件的句柄。函数从文件内部位置指针所指向的位置开始写数据。
写操作完成后,文件位置指针按照实际写入的字节数进行调整。函数原型如下:
WriteFile PROTO,
hFile:HANDLE, ;输出句柄
lpBuffer:PTR BYTE, ;缓冲区指针
nNumberOfBytesToWrite:DWORD, ;缓冲区大小
lpNumberOfBytesWritten:PTR DWORD, ;写入字节数
lpOverlapped:PTR DWORD ;异步信息指针
其中:
- hFile 是已打开文件的句柄;
- lpBuffer 指向的缓冲区包含了写入到文件的数据;
- nNumberOfBytesToWrite 指定向文件写入多少字节;
- lpNumberOfBytesWritten 指向的整数为函数执行后实际写入的字节数;
- 若为同步操作,则 lpOverlapped 应被设置为 NULL。若函数调用失败,则返回值为零。