WriteFile函数

WriteFile函数:

该函数的功能是往文件中写数据,该函数可用来完成同步和异步操作的。写入的位置是由文件指针制定的文字,在完成写操作后,文件的指针会移动到文件新增加的字节的最后(当然这是在文件打开的方式不是FILE_FLAG_OVERLAPPED)。

函数原型:

BOOL WriteFile( HANDLE hFile, // handle to file LPCVOID lpBuffer, // data buffer DWORDnNumberOfBytesToWrite, // number of bytes to write LPDWORD lpNumberOfBytesWritten, // number of bytes written LPOVERLAPPED lpOverlapped // overlapped buffer );

返回值:

如果函数成功返回TRUE,否则返回FALSE。

参数:

hFile——已经打开的文件句柄。

lpBuffer——缓冲区头指针,它的类型是 LPCVOID ,可以不经转化地传递任意类型的指针,如果需要传递的是一个例化的结构体,则可以使用“&”操作取地址。

nNumberOfBytesToWrite——将要写入的字节数。

lpNumberOfBytesWritten——实际写入的字节数。

lpOverlapped——指向一个OVERLAPPED结构。大多数情况使用NULL。

函数WriteFile和ReadFile声明如下:

WINBASEAPI

BOOL

WINAPI

WriteFile(

__in HANDLE hFile,

__in_bcount(nNumberOfBytesToWrite) LPCVOID lpBuffer,

__in DWORD nNumberOfBytesToWrite,

__out_opt LPDWORD lpNumberOfBytesWritten,

__inout_opt LPOVERLAPPED lpOverlapped

);

WINBASEAPI

BOOL

WINAPI

ReadFile(

__in HANDLE hFile,

__out_bcount_part(nNumberOfBytesToRead, *lpNumberOfBytesRead) LPVOID lpBuffer,

__in DWORD nNumberOfBytesToRead,

__out_opt LPDWORD lpNumberOfBytesRead,

__inout_opt LPOVERLAPPED lpOverlapped

);

hFile是文件句柄。

lpBuffer是读写数据缓冲区。

nNumberOfBytesToWrite是多少数据要写入。

lpNumberOfBytesWritten是已经写入多少数据。

nNumberOfBytesToRead是多少数据要读取。

nNumberOfBytesToRead是已经读取多少数据。

lpOverlapped是异步读写的结构。

调用函数的例子如下:

#001 //创建、写入、读取文件。

#002 //蔡军生 2007/10/21 QQ:9073204 深圳

#003 void CreateFileDemo(void)

#004 {

#005 //

#006 HANDLE hFile = ::CreateFile(_T("CreateFileDemo.txt"), //创建文件的名称。

#007 GENERIC_WRITE|GENERIC_READ, // 写和读文件。

#008 0, // 不共享读写。

#009 NULL, // 缺省安全属性。

#010 CREATE_ALWAYS, // 如果文件存在,也创建。

#011 FILE_ATTRIBUTE_NORMAL, // 一般的文件。

#012 NULL); // 模板文件为空。

#013

#014 if (hFile == INVALID_HANDLE_VALUE)

#015 {

#016 //

#017 OutputDebugString(_T("CreateFile fail!/r/n"));

#018 }

#019

#020 //往文件里写数据。

#021 const int BUFSIZE = 4096;

#022 char chBuffer[BUFSIZE];

#023 memcpy(chBuffer,"Test",4);

#024 DWORD dwWritenSize = 0;

#025 BOOL bRet = ::WriteFile(hFile,chBuffer,4,&dwWritenSize,NULL);

#026 if (bRet)

#027 {

#028 //

#029 OutputDebugString(_T("WriteFile 写文件成功/r/n"));

#030 }

#031

#032 //先把写文件缓冲区的数据强制写入磁盘。

#033 FlushFileBuffers(hFile);

#034

#035 //

#036 //从文件里读取数据。

#037 LONG lDistance = 0;

#038 DWORD dwPtr = SetFilePointer(hFile, lDistance, NULL, FILE_BEGIN);

#039 if (dwPtr == INVALID_SET_FILE_POINTER)

#040 {

#041 //获取出错码。

#042 DWORD dwError = GetLastError() ;

#043 //处理出错。

#044 }

#045

#046 DWORD dwReadSize = 0;

#047 bRet = ::ReadFile(hFile,chBuffer,4,&dwReadSize,NULL);

#048 if (bRet)

#049 {

#050 //

#051 OutputDebugString(_T("ReadFile 读文件成功/r/n"));

#052 }

#053 else

#054 {

#055 //获取出错码。

#056 DWORD dwError = GetLastError();

#057 //处理出错。

#058 TCHAR chErrorBuf[1024];

#059 wsprintf(chErrorBuf,_T("GetLastError()=%d/r/n"),dwError);

#060 OutputDebugString(chErrorBuf);

#061 }

#062

#063 }

2025-07-08 00:21:03