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 }