Creates or opens a file or I/O device.
__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
CreateFile用法和例子
函数原型:
HANDLE CreateFile(
LPCTSTR lpFileName, //指向文件名的指针
DWORD dwDesiredAccess, //访问模式(写/读)
DWORD dwShareMode, //共享模式
LPSECURITY_ATTRIBUTES lpSecurityAttributes, //指向安全属性的指针
DWORD dwCreationDisposition, //如何创建
DWORD dwFlagsAndAttributes, //文件属性
HANDLE hTemplateFile //用于复制文件句柄
);
参数列表
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
(以上摘自百度百科)
实例:
1、直接在函数内指定文件地址:
- void playCEwav()
- {
- CHAR *pBuffer;
- DWORD RSize;
- int fileSize = 0;
- int i;
- HANDLE hOpenFile = (HANDLE)CreateFile(L"E:\\a.text", GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, NULL, NULL);
- if (hOpenFile == INVALID_HANDLE_VALUE)
- {
- hOpenFile = NULL;
- MessageBoxA(NULL, "Can not open the file", "Playwav", MB_OK);
- }
- fileSize = GetFileSize(hOpenFile, NULL);
- pBuffer = (CHAR *) malloc(fileSize);
- ReadFile(hOpenFile, pBuffer, fileSize, &RSize, NULL);
- //可将pBuffer显示在某区域或写入另一个文件来检查读出是否正确
- free(pBuffer);
- }
2、把文件地址通过参数传入:
- void playwav(TCHAR * path)
- {
- CHAR *pBuffer;
- DWORD RSize;
- int fileSize = 0;
- int i;
- TCHAR szPath[100];
- memset(szPath, 0, sizeof(szPath));
- _tcscpy(szPath, path);
- HANDLE hOpenFile = (HANDLE)CreateFile(szPath, GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, NULL, NULL);
- if (hOpenFile == INVALID_HANDLE_VALUE)
- {
- hOpenFile = NULL;
- MessageBoxA(NULL, "Can not open the file", "Playwav", MB_OK);
- }
- fileSize = GetFileSize(hOpenFile, NULL);
- pBuffer = (CHAR *) malloc(fileSize);
- ReadFile(hOpenFile, pBuffer, fileSize, &RSize, NULL);
- free(pBuffer);
- }