CreateFile 函数创建或打开下列对象,并返回一个可以用来访问这些对象的句柄。
文件
pipes
邮槽
通信资源
磁盘驱动器(仅适用于 windowsNT )
控制台
文件夹(仅用于打开)
HANDLE CreateFile(
LPCTSTR lpFileName, // 指向文件名的指针
DWORD dwDesiredAccess, // 访问模式(写 / 读)
DWORD dwShareMode, // 共享模式
LPSECURITY_ATTRIBUTES lpSecurityAttributes, // 指向安全属性的指针
DWORD dwCreationDisposition, // 如何创建
DWORD dwFlagsAndAttributes, // 文件属性
HANDLE hTemplateFile // 用于复制文件句柄
);
Parametes
参数列表
参数 |
类型及说明 |
|
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
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.
指向一个空结尾字符串。该参数指定了用于创建或打开句柄的对象。
if *lpFileName is a path, there is a default string size limit of MAX_PATH characters, This limit is
related to how the CreateFile function parses paths.
如果 lpFileName 的对象是一个路径,则有一个最大字符数的限制。不能超过常量 (MAX_PATH). 这个限制指示了
CreateFile 函数如何解析路径 .
dwDesiredAccess
Specifies the type of access to the object. An application can obtain read access, write access,
read-write access, or device query access, This parameter can be any combination of the following
values
指定对象的访问方式 , 程序可以获得读访问权 , 写访问权 , 读写访问权或者是询问设备 ("device query") 访问权 .
这个参数可以是下列值的任意组合
Value( 值 ) Meaning( 含义 )
0 Specifies device query access to the object. An application can query device
attributes without accessing the device.
指定询问访问权 . 程序可以在不直接访问设备的情况下查询设备的属性 .
GENERIC_READ Specifies read access to the object, Data can be read from the file and the
file pointer can be moved. Combine with GENERIC_WRITE for read-write access.
指定读访问权 . 可以从文件中读取数据 , 并且移动文件指针 . 可以和 GENERIC_WRITE 组合
成为 " 读写访问权 ".
GENERIC_WRITE specifies write access to the object. Data can be written to the file and the
file pointer can be moved. Combine with GENERIC_READ fro read-write access
指定写访问权 . 可以从文件中写入数据 , 并且移动文件指针 . 可以和 GENERIC_READ 组合
成为 " 读写访问权 ".
dwShareMode
Set of bit flags that specifies how the object can be shared, If dwShareMode is 0, the object cannot
be shared. Subsequent open operations on the object will fail, until the handle is closed.
设置位标志指明对象如休共享 . 如果参数是 0, 对象不能够共享 . 后续的打开对象的操作将会失败 , 直到该对象的句
柄关闭 .
To share the object, use a combination of one or more of the following values:
使用一个或多个下列值的组合来共享一个对象 .
Value( 值 ) Meaning( 含义 )
FILE_SHARE_DELETE WindowsNT: Subsequent open operations on the object will succeed only if
delete access is requested.
WINDOWS NT: 后续的仅仅请求删除访问权的打开操作将会成功 .
FILE_SHARE_READ Subsequent open operations on the object will successd only if read access
is requested.
后续的仅仅请求读访问权的打开操作将会成功 .