牛骨文教育服务平台(让学习变的简单)
博文笔记

ReadFile 函数

创建时间:2010-05-10 投稿人: 浏览次数:14422

函数原型   BOOL ReadFile(

  HANDLE hFile, //文件的句柄

  LPVOID lpBuffer, //用于保存读入数据的一个缓冲区

  DWORD nNumberOfBytesToRead, //要读入的字符数

  LPDWORD lpNumberOfBytesRead, //指向实际读取字节数的指针

  LPOVERLAPPED lpOverlapped //如文件打开时指定了FILE_FLAG_OVERLAPPED,那么必须,用这个参数引用一个特殊的结构。该结构定义了一次异步读取操作。否则,应将这个参数设为NULL

  );

功能说明

  从文件指针指向的位置开始将数据读出到一个文件中, 且支持同步和异步操作,

  如果文件打开方式没有指明FILE_FLAG_OVERLAPPED的话,当程序调用成功时,它将实际读出文件的字节数保存到lpNumberOfBytesRead指明的地址空间中

  如果文件要交互使用的话,当函数调用完毕时要记得调整文件指针

参数说明

  HANDLE hFile, 需要写入数据的文件指针,这个指针指向的文件必须是GENERIC_READaccess 访问属性的文件

  LPOVERLAPPED lpOverlapped OVERLAPPED结构体指针,如果文件是以FILE_FLAG_OVERLAPPED方式打开的话,那么这个指针就不能为NULL

返回值

  调用成功,返回非0

  调用不成功,返回为0

应用实例

  void ReadFile(char* str)

  {

  HANDLE pfile;

  pfile = ::CreateFile(str,GENERIC_READ,0,NULL,OPEN_EXISTING,

  FILE_ATTRIBUTE_NORMAL|FILE_FLAG_DELETE_ON_CLOSE,NULL); // 用这个函数比OpenFile好

  if ( pfile == INVALID_HANDLE_VALUE)

  {

  MessageBox( NULL,"打开文件失败" ,"Error",MB_OK);

  CloseHandle(pfile); // 一定注意在函数退出之前对句柄进行释放

  return;

  }

  DWORD filesize=GetFileSize(pfile,NULL);

  char* buffer=new char[filesize+1]; // 最后一位为 "/0",C-Style 字符串的结束符

  DWORD readsize;

  ReadFile(pfile,buffer,filesize,&readsize,NULL);

  buffer[filesize]=0;

  MessageBox(BULL,buffer,"Buffer Size",MB_OK);

  // 善后工作

  delete[] buffer; // 注意是delete[] 而不是 delete

  CloseHandle(pfile); // 关闭句柄

  }

声明:该文观点仅代表作者本人,牛骨文系教育信息发布平台,牛骨文仅提供信息存储空间服务。