CreateFile用法和例子


函数原型: 

HANDLE CreateFile( 

   LPCTSTR lpFileName, //指向文件名的指针 

   DWORD dwDesiredAccess, //访问模式(写/读) 

   DWORD dwShareMode, //共享模式 

   LPSECURITY_ATTRIBUTES lpSecurityAttributes, //指向安全属性的指针 

   DWORD dwCreationDisposition, //如何创建 

   DWORD dwFlagsAndAttributes, //文件属性 

   HANDLE hTemplateFile //用于复制文件句柄 

   );


  参数列表 


  lpFileName String 要打开的文件的名字 


  dwDesiredAccess Long 如果为 GENERIC_READ 表示允许对设备进行读访问;如果为 GENERIC_WRITE 表示允许对设备进行写访问(可组合使用);如


果为零,表示只允许获取与一个设备有关的信息 


  dwShareMode Long, 零表示不共享; FILE_SHARE_READ 和/或 FILE_SHARE_WRITE 表示允许对文件进行共享访问


  lpSecurityAttributes SECURITY_ATTRIBUTES, 指向一个SECURITY_ATTRIBUTES结构的指针,定义了文件的安全特性(如果操作系统支持的话)


  dwCreationDisposition Long,下述常数之一: 


  CREATE_NEW 创建文件;如文件存在则会出错 


  CREATE_ALWAYS 创建文件,会改写前一个文件 


  OPEN_EXISTING 文件必须已经存在。由设备提出要求 


  OPEN_ALWAYS 如文件不存在则创建它 


  TRUNCATE_EXISTING 讲现有文件缩短为零长度 


  dwFlagsAndAttributes Long, 一个或多个下述常数 


  FILE_ATTRIBUTE_ARCHIVE 标记归档属性 


  FILE_ATTRIBUTE_COMPRESSED 将文件标记为已压缩,或者标记为文件在目录中的默认压缩方式 


  FILE_ATTRIBUTE_NORMAL 默认属性 


  FILE_ATTRIBUTE_HIDDEN 隐藏文件或目录 


  FILE_ATTRIBUTE_READONLY 文件为只读 


  FILE_ATTRIBUTE_SYSTEM 文件为系统文件 


  FILE_FLAG_WRITE_THROUGH 操作系统不得推迟对文件的写操作 


  FILE_FLAG_OVERLAPPED 允许对文件进行重叠操作 


  FILE_FLAG_NO_BUFFERING 禁止对文件进行缓冲处理。文件只能写入磁盘卷的扇区块 


  FILE_FLAG_RANDOM_ACCESS 针对随机访问对文件缓冲进行优化 


  FILE_FLAG_SEQUENTIAL_SCAN 针对连续访问对文件缓冲进行优化 


  FILE_FLAG_DELETE_ON_CLOSE 关闭了上一次打开的句柄后,将文件删除。特别适合临时文件


  也可在Windows NT下组合使用下述常数标记: 


  SECURITY_ANONYMOUS, SECURITY_IDENTIFICATION, SECURITY_IMPERSONATION, SECURITY_DELEGATION, SECURITY_CONTEXT_TRACKING, 


        SECURITY_EFFECTIVE_ONLY 


  hTemplateFile Long, 如果不为零,则指定一个文件句柄。新文件将从这个文件中复制扩展属性



返回值


  如执行成功,则返回文件句柄。


  INVALID_HANDLE_VALUE表示出错,会设置GetLastError。即使函数成功,但若文件存在,且指定了CREATE_ALWAYS 或 OPEN_ALWAYS,GetLastError也会设为ERROR_ALREADY_EXISTS