Windows API —CreateFile

最新推荐文章于 2024-08-30 23:50:50 发布

iot-genius

最新推荐文章于 2024-08-30 23:50:50 发布

阅读量2k

点赞数 1

分类专栏： Windows程序设计

本文链接：https://blog.csdn.net/wangqiulin123456/article/details/8490839

版权

Windows程序设计专栏收录该内容

35 篇文章 3 订阅

订阅专栏

这个函数可以创建或打开一个对象的句柄，凭借此句柄就可以控制这些对象：
控制台对象、通信资源对象、目录对象(只能打开)、磁盘设备对象、文件对象、邮槽对象、管道对象。
函数原型：

HANDLE CreateFile(
         LPCTSTR lpFileName,                         // 文件名
         DWORD dwDesiredAccess,                      // 访问模式
         DWORD dwShareMode,                          // 共享模式
         LPSECURITY_ATTRIBUTES lpSecurityAttributes, // 安全属性(也即销毁方式)
         DWORD dwCreationDisposition,                // how to create
         DWORD dwFlagsAndAttributes,                 // 文件属性
         HANDLE hTemplateFile                        // 模板文件句柄
         );

【参数】
1、lpFileName
    一个指向无终结符的字符串的指针，来指明要创建或打开的对象的名字。
    在Windows NT/2000/XP平台上：如果用ANSI版本的函数，字符串长度应限制在MAX_PATH；如果用Unicode版本的函数，这个限制可以扩充到32000个Unicode字符。
    在Windows95/98/Me平台上：只能用ANSI版本的函数，字符串长度限制在MAX_PATH。

2、dwDesiredAccess
    指明对象的控制模式。一个应用程序可以包含读控制、写控制、读/写控制、设备查询控制。
这个参数的取值可以是下面这些的组合：
    0                                             指定设备查询控制：程序可以不访问设备就查询到设备属性。
    GENERIC_READ                指定读控制，可以从对象中读取数据(指针将可以移动)。
    GENERIC_WRITE               指定写控制，可以向对象中写数据(指针将可以移动)。
    ----------------------------------------------------------------------
    另外，还可以指定下面的控制标志：
标准控制权限(16-23位掩码)：
    DELETE                     删除对象的权限。
    READ_CONTROL    从对象的安全描述符中读取信息的权限，但不包括SACL(系统访问控制列表)中的信息。
    WRITE_DAC              修改对象安全描述符中的DACL(随机访问控制列表)的权限
    WRITE_OWNER      修改对象安全描述符中的属主的权限
    SYNCHRONIZE     同步化使用对象的权限，即可以创建一个线程等待信号量释放(但有些对象不支持这个权限)。
    STANDARD_RIGHTS_REQUIRED    等价于前面四种权限的总合(通常这四种是必须具有的权限)。
    STANDARD_RIGHTS_READ        一般等价于READ_CONTROL
    STANDARD_RIGHTS_WRITE       一般等价于READ_CONTROL
    STANDARD_RIGHTS_EXECUTE     一般等价于READ_CONTROL
    STANDARD_RIGHTS_ALL         等价于前面五种权限的总合。
特殊控制权限(0-15位掩码)：
    SPECIFIC_RIGHTS_ALL
    ACCESS_SYSTEM_SECURITY
    MAXIMUM_ALLOWED
    GENERIC_READ
    GENERIC_WRITE
    GENERIC_EXECUTE
    GENERIC_ALL
注：实质上是通过ACCESS_MASK结构体的一个双字值来设置标准权限、特殊权限和一般权限的。

3、dwShareMode
    指定对象的共享模式。如果dwShareMode==0,表示是互斥使用的。如果CreateFile打开成功，则别的程序只能等到当前程序关闭对象句柄CloseHandle后才能在打开或使用。
    使用下面这些值的组合来表示对象的共享模式：
    FILE_SHARE_DELETE       Windows NT/2000/XP:打开操作只有在删除请求发生时才能返回成功。
    FILE_SHARE_READ                 打开操作只有在读控制请求发生时才能返回成功。
    FILE_SHARE_WRITE                打开操作只有在写控制请求发生时才能返回成功。

4、lpSecurityAttributes
一个指向SECURITY_ATTRIBUTES结构对象的指针，决定返回的句柄是否被子进程所继承。如果lpSecurityAttributes参数为NULL，句柄就不能被子进程继承。
在Windows NT/2000/XP平台下：lpSecurityDescriptor这个成员指明了这个对象的安全描述符。如果lpSecurityAttributes参数为NULL，对象将获得一个默认的安全描述符。目标文件系统必须为这个参数的在文件上的有效操作保证安全性。

typedef struct _SECURITY_ATTRIBUTES { 
       DWORD nLength; //结构体的大小(字节为单位),即siziof(SECURITY_ATTRIBUTES)
       LPVOID lpSecurityDescriptor; //指向对象的安全描述符的指针，控制对象的共享属性。在Windows 95/98/Me平台                                                     //上这个成员被忽略。
       BOOL   bInheritHandle; //指明当一个新的子进程创建时，是否继承当前返回的句柄
 } SECURITY_ATTRIBUTES, *PSECURITY_ATTRIBUTES;

5、dwCreationDisposition
    指明当打开的对象存在或不存在的时候各需怎样处理。这个参数必须是一下值的其中之一：
    CREATE_NEW            创建新文件/对象(当对象已经存在是将返回失败)。
    CREATE_ALWAYS         总是创建(如果对象存在就覆盖它，清除当前属性，把文件属性和dwFlagsAndAttributes指定的标志相结合)。
    OPEN_EXISTING         打开文件(如果不存在就返回失败)。
    OPEN_ALWAYS      存在就打开；若不存在，假如dwCreationDisposition==CREATE_NEW就创建一个新文件。
    TRUNCATE_EXISTING     存在就打开，且清空文件内容(至少要有GENERIC_WRITE权限)；若文件不存在就返回失败。

6、dwFlagsAndAttributes
    指定文件属性和标志。可以是以下值的任意组合(只有FILE_ATTRIBUTE_NORMAL必须单独使用，唯一例外)：
Attribute：
    FILE_ATTRIBUTE_ARCHIVE                 文件存档(备份或移动时会对文件做标记)。
    FILE_ATTRIBUTE_ENCRYPTED               加密(对文件来说是内容加密,对目录来说是对将来新建的文件默认为加密属性)，与此同时，如果还设置了FILE_ATTRIBUTE_SYSTEM属性，当前这个属性将无效。
    FILE_ATTRIBUTE_HIDDEN                  隐藏属性。
    FILE_ATTRIBUTE_NORMAL                  文件没有其他属性设置，此属性只能单独使用才合法。
    FILE_ATTRIBUTE_NOT_CONTENT_INDEXED     不建立内容索引。
    FILE_ATTRIBUTE_OFFLINE                 脱机属性。文件内容暂时不可用。此属性被Remote Storage软件所用，不能任意更改。
    FILE_ATTRIBUTE_READONLY                只读文件属性。应用程序不能写或删除。
    FILE_ATTRIBUTE_SYSTEM                  文件是系统文件或被操作系统互斥地使用。
    FILE_ATTRIBUTE_TEMPORARY               临时文件，使用过程中尽量留在内存以保证存取速度。
Flag：
    FILE_FLAG_WRITE_THROUGH            指示系统立即写磁盘。这个写操作允许被cache缓存，但不能被搁置。
    FILE_FLAG_OVERLAPPED                   指示系统初始化对象，如果操作需要大量时间执行就先返回一个 ERROR_IO_PENDING，当操作完成后再通过事件使能信号量。指定这个标志就必须在read和write函数里初始化OVERLAPPED 结构体，应用程序必须执行重复的读写操作。此时，操作系统不维护文件指针，当前的位置   需要通过OVERLAPPED的指针传递给读写函数。这个标志还允许多个操作的并行(并行读写)。
    FILE_FLAG_NO_BUFFERING                 指示系统不要缓冲，它如果和FILE_FLAG_OVERLAPPED联合使用，将呈现最好的异步性能，因为I/O操作并不依赖于内存管理器的同步性。但是有时I/O操作会慢些，因为没用cache。有时程序需要做调整，比如文件大小必须是扇区大小的整数倍，Buffer地址的按扇区地址对齐等。按扇区地址对齐内存边界可以使用VirtualAlloc来分配内存，GerDiskFreeSpace函数可以得到磁盘一个扇区的大小。
    FILE_FLAG_RANDOM_ACCESS                指示文件进行随即存取，系统可据此对cache的分配进行优化。
    FILE_FLAG_SEQUENTIAL_SCAN              指示顺序存取，系统也可据此对cache的分配进行优化。即使有随即存取的操作，也不会出错,不过cache的优化就取消了。在连续读取大文件时性能非常好。
    FILE_FLAG_DELETE_ON_CLOSE              指示系统在句柄关闭时将响应的文件立即删除，对当前句柄以外的其他句柄也有效。而且随后的打开请求也会失败，直到你使用了FILE_SHARE_DELETE属性。
    FILE_FLAG_BACKUP_SEMANTICS             在Windows NT/2000/XP平台上：指示文件作为备份或恢复文件打开，这是如果调用进程拥有特殊权限(SE_BACKUP_NAME 或 SE_RESTORE_NAME)，就可以不进行安全检查。也可以在获得一个目录的句柄时设置这个flag，目录句柄可以代替文件句柄传递给一些函数。
    FILE_FLAG_POSIX_SEMANTICS              指明按照操作系统接口规范进行文件存取，这包括允许多文件名的使用。请谨慎使用，因为MS_DOS或16位Windows系统可能不支持。
    FILE_FLAG_OPEN_REPARSE_POINT           这个标志指明禁止文件系统的重解析点的动作。文件打开时就返回文件的句柄，而不在乎控制重解析点的过滤器是否可运行。不能和CREATE_ALWAYS同时使用。
    FILE_FLAG_OPEN_NO_RECALL               表明文件数据被请求，但仍然驻留在远程存储体中，而不会被传回本地存储体。这个标志由远程存储系统或分层存储管理系统使用。
    如果CreateFile函数打开一个命名管道的客户端，dwFlagsAndAttributes 参数也会包含服务信息的安全性。当调用程序指定了
SECURITY_PRESENT标志时，dwFlagsAndAttributes 参数可以取以下一个或多个值：
    SECURITY_ANONYMOUS                  指定将客户端模拟在匿名级别(the Anonymous impersonation level)
    SECURITY_IDENTIFICATION             指定将客户端模拟在身份认证级别(the Identification impersonation level)
    SECURITY_IMPERSONATION              指定将客户端模拟在伪装级别(the Impersonation impersonation level)
    SECURITY_DELEGATION                 指定将客户端模拟在授权级别(the Delegation impersonation level)
    SECURITY_CONTEXT_TRACKING           指定安全跟踪模式是动态的，否则(不指定此标志)是静态的
    SECURITY_EFFECTIVE_ONLY             指定客户端的安全内容中的有效内容才可以被服务端使用，否则所有内容都可被使用。这个标志允许客户端限制服务端在模拟客户端时所具有的权限。

7、hTemplateFile
把具有GENERIC_READ权限的句柄指定为一个模板文件。这个模板文件提供了文件属性和扩展属性，用于创建文件。在Windows95/98/Me平台上：这个参数必须为空，否则如果你提供一个句柄，函数调用将会失败，用GerLastError函数获得的出错信息为ERROR_NOT_SUPPORTED。

【Return Values】
    调用如果成功，返回值时一个打开文件的句柄。
    如果调用之前文件已存在，且dwCreationDisposetion 为CREATE_ALWAYS或OPEN_ALWAYS，用GetLastError返回ERROR_ALREADY_EXISTS。
(即使调用成功也会返回这个值)。如果调用之前不存在，GetLastError返回0。
    调用如果失败，返回值是INVALID_HANDLE_VALUE。要进一步了解出错原因，调用GetLastError。