CreateFile()----同步

CreateFile:一个多功能的函数，打开或创建以下对象，并返回可访问的句柄：控制台，通信资源，目录(只读打开)，磁盘驱动器，文件，邮槽，管道。并返回一个可以用来访问这些对象的句柄。

注意：CreateFile的涵义是创建File这个内核对象，而不是创建物理磁盘上的“文件”。在Win32 API中有一系列操作内核对象的函数，创建内核对象的函数大多命名为CreateXxxx型。

函数原型：
HANDLE WINAPI CreateFile
(
_In_ LPCTSTR lpFileName,    

_In_ DWORD dwDesiredAccess,

_In_ DWORD dwShareMode,

_In_opt_ LPSECURITY_ATTRIBUTES lpSecurityAttributes,

_In_ DWORD dwCreationDisposition,

_In_ DWORD dwFlagsAndAttributes,

_In_opt_ HANDLE hTemplateFile

);

参数说明：

LPCTSTR lpFileName  要打开的文件的名或设备名。
这个字符串的最大长度在ANSI版本中为MAX_PATH，在unicode版本中为32767。

DWORD dwDesiredAccess  访问方式
GENERIC_READ 表示允许对设备进行读访问；
GENERIC_WRITE 表示允许对设备进行写访问（可组合使用）；
零，表示只允许获取与一个设备有关的信息

DWORD dwShareMode  共享模式
零表示不共享；
FILE_SHARE_DELETE表示随后打开操作对象会成功只要删除访问请求；
FILE_SHARE_READ随后打开操作对象会成功只有请求读访问；
FILE_SHARE_WRITE 随后打开操作对象会成功只有请求写访问。

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

DWORD dwCreationDisposition  创建方式
下述常数之一：
CREATE_NEW 创建文件；如文件存在则会出错

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

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

OPEN_ALWAYS 如文件不存在则创建它

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

DWORD dwFlagsAndAttributes   文件属性
一个或多个下述常数：

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 关闭了上一次打开的句柄后，将文件删除。特别适合临时文件

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

返回值：

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

INVALID_HANDLE_VALUE表示出错，会设置GetLastError。

即使函数成功，但若文件存在，且指定了CREATE_ALWAYS 或 OPEN_ALWAYS，GetLastError也会设为ERROR_ALREADY_EXISTS