文件读写(Windows API)--CreateFile的使用

这是一个全功能的例程,可打开和创建文件、管道、邮槽、通信服务、设备以及控制台。

函数原型:
HANDLE CreateFile(
  LPCTSTR lpFileName, //指向文件名的指针
  DWORD dwDesiredAccess, //访问模式(写/读)
  DWORD dwShareMode, //共享模式
  LPSECURITY_ATTRIBUTES lpSecurityAttributes, //指向安全属性的指针
  DWORD dwCreationDisposition, //如何创建
  DWORD dwFlagsAndAttributes, //文件属性
  HANDLE hTemplateFile //用于复制文件句柄
  );
示例:
m_hFile = (HANDLE)CreateFile(strFileName, GENERIC_READ,
         FILE_SHARE_READ, NULL, 
         OPEN_EXISTING, NULL, NULL);
  • 如果把GENERIC_READ改成GENERIC_WRITE,编译不会报错,但是-强行读取文件内容失败,所以在使用参数的时候,要考虑到想用这个打开的文件做什么,然后根据要做的事情来选择对应的参数。
返回值:

如执行成功,则返回文件句柄。通过GetLastError可以查看错误,比如INVALID_HANDLE_VALUE、ERROR_ALREADY_EXISTS。

参数分析:
  • lpFileName String 要打开的文件的名字
  • dwDesiredAccess Long 如果为 GENERIC_READ 表示允许对设备进行读访问;如果为 GENERIC_WRITE 表示允许对设备进行写访问(可组合使用);如果为零,表示只允许获取与一个设备有关的信息
  • dwShareMode Long, 零表示不共享; FILE_SHARE_READ 和/或 FILE_SHARE_WRITE 表示允许对文件进行共享访问
  • lpSecurityAttributes SECURITY_ATTRIBUTES, 指向一个SECURITY_ATTRIBUTES结构的指针,定义了文件的安全特性
  • dwCreationDisposition Long,下述常数之一:
  1. CREATE_NEW 创建文件;如文件存在则会出错 。这种情况下,返回值为INVALID_HANDLE_VALUE,GetLastRrror为80-文件存在。
  2. CREATE_ALWAYS 创建文件,会改写前一个文件。在打开文件的时候,如果文件存在,则会把之前文件中的内容清空;文件不存在则创建新的文件。
  3. OPEN_EXISTING 文件必须已经存在。由设备提出要求 。如果不存在,GetLastError返回2-系统找不到指定的文件。
  4. OPEN_ALWAYS 如文件不存在则创建它
  5. TRUNCATE_EXISTING 讲现有文件缩短为零长度。这个参数在使用时一定要有写的权限,否则会提示参数出错。GetLastError87-参数错误
  • dwFlagsAndAttributes Long, 一个或多个下述常数
      1. FILE_ATTRIBUTE_ARCHIVE 标记归档属性
      2. FILE_ATTRIBUTE_COMPRESSED 将文件标记为已压缩,或者标记为文件在目录中的默认压缩方式
      3. FILE_ATTRIBUTE_NORMAL 默认属性
    4. FILE_ATTRIBUTE_HIDDEN 隐藏文件或目录
      5. FILE_ATTRIBUTE_READONLY 文件为只读
      6. FILE_ATTRIBUTE_SYSTEM 文件为系统文件
      7. FILE_FLAG_WRITE_THROUGH 操作系统不得推迟对文件的写操作
      8. FILE_FLAG_OVERLAPPED 允许对文件进行重叠操作
      9. FILE_FLAG_NO_BUFFERING 禁止对文件进行缓冲处理。文件只能写入磁盘卷的扇区块
      10. FILE_FLAG_RANDOM_ACCESS 针对随机访问对文件缓冲进行优化
      11. FILE_FLAG_SEQUENTIAL_SCAN 针对连续访问对文件缓冲进行优化
      12. FILE_FLAG_DELETE_ON_CLOSE 关闭了上一次打开的句柄后,将文件删除。特别适合临时文件
      13. 也可在Windows NT下组合使用下述常数标记:
      SECURITY_ANONYMOUS, SECURITY_IDENTIFICATION, SECURITY_IMPERSONATION, SECURITY_DELEGATION, SECURITY_CONTEXT_TRACKING, SECURITY_EFFECTIVE_ONLY
  • hTemplateFile Long, 如果不为零,则指定一个文件句柄。新文件将从这个文件中复制扩展属性

你可能感兴趣的:(文件读写(Windows API)--CreateFile的使用)