CreateFile使用方法和样例
函数原型:
HANDLE CreateFile(
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);
- }