Creates or opens a file or I/O device.
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 //用于复制文件句柄);lpFileName
指向一个空结尾字符串。该参数指定了用于创建或打开句柄的对象。
dwDesiredAccess
指定对象的访问方式,程序可以获得读访问权,写访问权,读写访问权或者是询问设备访问权. 这个参数可以是下列值的任意组合GENERIC_READ, GENERIC_WRITE, or both (GENERIC_READ | GENERIC_WRITE). 0指定询问访问权.程序可以在不直接访问设备的情况下查询设备的属性.
dwShareMode
设置位标志指明对象如何共享.如果参数是0, 对象不能够共享. 后续的打开对象的操作将会失败,直到该对象的句柄关闭. 使用一个或多个下列值的组合来共享一个对象.
| Value |
Meaning |
| 0 0x00000000 |
对象不能够共享. 后续的打开对象的操作将会失败,直到该对象的句柄关闭. |
|
FILE_SHARE_DELETE |
后续的仅仅请求删除访问权的打开操作将会成功. 删除访问也包含重命名操作. |
|
FILE_SHARE_READ |
后续的仅仅请求读访问权的打开操作将会成功. |
|
FILE_SHARE_WRITE |
后续的仅仅请求写访问权的打开操作将会成功. |
lpSecurityAttributes
指向一个 SECURITY_ATTRIBUTES 结构的指针用于确定如何在子进程中继承这个句柄.如果这个参数是NULL,则该句柄不可继承.
dwCreationDisposition
指定当文件存在或者不存在时如何动作。对设备来讲一般设置为OPEN_EXISTING. 这个参数必须是一个或多个下列值.
|
Value |
Meaning |
|
CREATE_ALWAYS |
创建一个新文件.如果该文件已经存在,函数将覆盖已存在的文件并清除已存在的文件属性. |
|
CREATE_NEW |
创建一个新文件. 如果该文件已经存在函数则会失败. |
|
OPEN_ALWAYS |
如果文件存在,打开文件. 如果文件不存在,并且参数中有CREATE_NEW标志,则创建文件. |
|
OPEN_EXISTING |
打开一个存在的文件或设备, 如果指定的文件或设备不存在则函数就会失败. |
|
TRUNCATE_EXISTING |
打开一个文件,每次打开,文件将被截至0字节.调用进程必须用GENERIC_WRITE访问模式打开文件.如果文件不存在则函数就会失败. |
为文件指定属性和标志位. 通常使用FILE_ATTRIBUTE_NORMAL作为默认值. 该参数可以接收下列属性的任意组合. 当打开一个已经存在的文件的时候将把原有的文件属性与此绑定并且忽略此值.
|
Attribute |
Meaning |
|
FILE_ATTRIBUTE_ARCHIVE |
文件将被存档,程序使用此属性来标志文件去备份或移除. |
|
FILE_ATTRIBUTE_ENCRYPTED |
The file or directory is encrypted. For a file, this means that all data in the file is encrypted. For a directory, this means that encryption is the default for newly created files and subdirectories. For more information, see File Encryption. This flag has no effect if FILE_ATTRIBUTE_SYSTEM is also specified. |
|
FILE_ATTRIBUTE_HIDDEN |
文件被隐藏,它不会在一般文件夹列表中被装载. |
|
FILE_ATTRIBUTE_NORMAL |
文件没有被设置任何属性.只可单独设置此值. |
|
FILE_ATTRIBUTE_OFFLINE |
文件的数据不是立即可用。指出正在脱机使用该文件。 |
|
FILE_ATTRIBUTE_READONLY |
这个文件只可读取.程序可以读文件,但不可以在上面写入内容,也不可删除. |
|
FILE_ATTRIBUTE_SYSTEM |
文件是系统的一部分,或是系统专用的. |
|
FILE_ATTRIBUTE_TEMPORARY |
文件被使用后，文件系统将努力为（文件的）所有数据的迅迅访问保持一块内存. 临时文件应当在程序不用时及时删除. |
|
Flag |
Meaning |
|
FILE_FLAG_BACKUP_SEMANTICS |
指示系统为文件的打开或创建执行一个备份或恢复操作. 系统保证调用进程忽略文件的安全选项,倘若它必须有一个特权.则相关的特权则是SE_BACKUP_NAME 和SE_RESTORE_NAME. |
|
FILE_FLAG_DELETE_ON_CLOSE |
指示系统在文件所有打开的句柄关闭后立即删除文件. 如果没有使用FILE_SHARE_DELETE,后续的打开文件的请求将会失败. |
|
FILE_FLAG_NO_BUFFERING |
指示系统不使用快速缓冲区或缓存，当和FILE_FLAG_OVERLAPPED组合,该标志给出最大的异步操作量, 因为I/O不依赖内存管理器的异步操作.然而,一些I/O操作将会运行得长一些,因为数据没有控制在缓存中. 当使用FILE_FLAG_NO_BUFFERING打开文件进行工作时,程序必须达到一些严格的要求. |
|
FILE_FLAG_OVERLAPPED |
文件被以异步I/O操作方式打开. 当接下来的在此句柄上的I/O操作完成后, 在OVERLAPPED结构里的event将被置为有信号状态. 设置此标志,文件将能够并行的进行读写操作 |
|
FILE_FLAG_POSIX_SEMANTICS |
指明文件符合POSIX标准.这是在MS-DOS与16位Windows下的标准. |
|
FILE_FLAG_RANDOM_ACCESS |
指定文件是随机访问,这个标志可以使系统优化文件的缓冲. |
|
FILE_FLAG_SEQUENTIAL_SCAN |
指定文件将从头到尾连续地访问.这个标志可以提示系统优化文件缓冲. |
|
FILE_FLAG_WRITE_THROUGH |
直接写数据到磁盘,不经过缓存. |
hTemplateFile
一个指向带有GENERIC_READ访问权限的模板文件的句柄.模板文件在文件开始创建后提供文件属性和扩展属性.该参数可为NULL.
Return Value
如果函数成功,返回一个打开的指定文件的句柄.失败则会返回INVALID_HANDLE_VALUE.
