1、概念:
这是一个多功能的函数,可打开或创建文件或者I/O设备,并返回可访问的句柄:控制台,通信资源,目录(只读打开),磁盘驱动器,文件,邮槽,管道。
HANDLE CreateFile(
LPCTSTR lpFileName, // 指向文件名的指针
DWORD dwDesiredAccess, // 访问模式(写 / 读)
DWORD dwShareMode, // 共享模式
LPSECURITY_ATTRIBUTES lpSecurityAttributes, // 指向安全属性的指针
DWORD dwCreationDisposition, // 如何创建
DWORD dwFlagsAndAttributes, // 文件属性
HANDLE hTemplateFile // 用于复制文件句柄
);
2、返回值:
如执行成功,则返回文件句柄。 INVALID_HANDLE_VALUE 表示出错,会设置 GetLastError 。即使函数成功,但若文件存在,且指定了 CREATE_ALWAYS 或 OPEN_ALWAYS ,GetLastError 也会设为 ERROR_ALREADY_EXISTS
lpFileName
Pointer to a null-terminated string that specifies the name of the object(file, pipe, mailslot,
communications resource, disk device, console, or directory) to create or open.
指向一个空结尾字符串。该参数指定了用于创建或打开句柄的对象。
3、参数列表:
参数 |
类型及说明 |
|
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 ,如果不为零,则指定一个文件句柄。新文件将从这个文件中复制扩展属性 |
4、遇到的坑
HID通讯时会使用 Ptr device = CreateFile()的方式去打开HID文件,我们一般把第三个参数选择为FILE_SHARE_READ来过滤掉鼠标键盘等一些不是我们想要的设备
我先用Ptr device = CreateFile()来遍历所有设备,然后再打开(这里调用了Ptr device = CreateFile()两次,一次遍历一次打开,分别放大两个函数里)
结果就是第二遍调用Ptr device = CreateFile()时报错
原因是我们已经打开了这个设备,需要释放句柄才能再次打开
所以遍历的时候,每打开一个设备,需要释放对应的句柄
CloseHandle(device); //释放打开的句柄(参数是句柄,即函数CreateFile()的返回值)