1. CreateFile
这个函数的功能是创建或者打开一个文件或者I/O设备,通常使用的I/O形式有文件、文件流、目录、物理磁盘、卷、终端流等。如执行成功,则返回文件句柄。 INVALID_HANDLE_VALUE 表示出错,会设置 GetLastError 。
函数的声明定义:
-
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 | 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 ,一个或多个下述常数: FLE_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 关闭了上一次打开的句柄后,将文件删除。特别适合临时文件; |
hTemplateFile | Long ,如果不为零,则指定一个文件句柄。新文件将从这个文件中复制扩展属性 |
2. ReadFile
从文件指针指向的位置开始将数据读出到一个文件中, 且支持同步和异步操作,如果文件打开方式没有指明FILE_FLAG_OVERLAPPED的话,当程序调用成功时,它将实际读出文件的字节数保存到lpNumberOfBytesRead指明的地址空间中。FILE_FLAG_OVERLAPPED 允许对文件进行重叠操作。
函数声明定义:
-
BOOL WINAPI ReadFile(
-
__
in HANDLE hFile,
// 文件句柄
-
__
out LPVOID lpBuffer,
// 接收数据用的 buffer
-
__
in DWORD nNumberOfBytesToRead,
// 要读取的字节数
-
__
out LPDWORD lpNumberOfBytesRead,
// 实际读取到的字节数
-
__
in LPOVERLAPPED lpOverlapped
// OVERLAPPED 结构,一般设定为 NULL
-
);
代码示例:
-
BOOL Read(char *filePath)
-
{
-
HANDLE pFile;
-
DWORD fileSize;
-
char *buffer,*tmpBuf;
-
DWORD dwBytesRead,dwBytesToRead,tmpLen;
-
-
pFile = CreateFile(filePath,GENERIC_READ,
-
FILE_SHARE_READ,
-
NULL,
-
OPEN_EXISTING,
//打开已存在的文件
-
FILE_ATTRIBUTE_NORMAL,
-
NULL);
-
-
if ( pFile == INVALID_HANDLE_VALUE)
-
{
-
printf(
"open file error!\n");
-
CloseHandle(pFile);
-
return FALSE;
-
}
-
-
fileSize = GetFileSize(pFile,
NULL);
//得到文件的大小
-
-
buffer = (
char *)
malloc(fileSize);
-
ZeroMemory(buffer,fileSize);
-
dwBytesToRead = fileSize;
-
dwBytesRead =
0;
-
tmpBuf = buffer;
-
-
do{
//循环读文件,确保读出完整的文件
-
-
ReadFile(pFile,tmpBuf,dwBytesToRead,&dwBytesRead,
NULL);
-
-
if (dwBytesRead ==
0)
-
break;
-
-
dwBytesToRead -= dwBytesRead;
-
tmpBuf += dwBytesRead;
-
-
}
while (dwBytesToRead >
0);
-
-
// TODO 处理读到的数据 buffer
-
-
free(buffer);
-
CloseHandle(pFile);
-
-
return TRUE;
-
}
3. WriteFile
将数据写入一个文件。该函数比fwrite函数要灵活的多。也可将这个函数应用于对通信设备、管道、套接字以及邮槽的处理。返回时,TRUE(非零)表示成功,否则返回零。会设置GetLastError。
函数声明定义:
-
BOOL WINAPI WriteFile(
-
__
in HANDLE hFile,
// 文件句柄
-
__
in LPCVOID lpBuffer,
// 要写入的数据
-
__
in DWORD nNumberOfBytesToWrite,
// 要写入的字节数
-
__
out LPDWORD lpNumberOfBytesWritten,
// 实际写入的字节数
-
__
in LPOVERLAPPED lpOverlapped
// OVERLAPPED 结构,一般设定为 NULL
-
);
代码示例:
-
BOOL Write(
char *buffer, DWORD contentLen)
-
{
-
HANDLE pFile;
-
char *tmpBuf;
-
DWORD dwBytesWrite,dwBytesToWrite;
-
-
pFile = CreateFile(filePath,GENERIC_WRITE,
-
0,
-
NULL,
-
CREATE_ALWAYS,
//总是创建文件
-
FILE_ATTRIBUTE_NORMAL,
-
NULL);
-
-
if ( pFile == INVALID_HANDLE_VALUE)
-
{
-
printf(
"create file error!\n");
-
CloseHandle(pFile);
-
return
FALSE;
-
}
-
-
dwBytesToWrite = contentLen;
-
dwBytesWrite =
0;
-
-
tmpBuf = buffer;
-
-
do{
//循环写文件,确保完整的文件被写入
-
-
WriteFile(pFile,tmpBuf,dwBytesToWrite,&dwBytesWrite,
NULL);
-
-
dwBytesToWrite -= dwBytesWrite;
-
tmpBuf += dwBytesWrite;
-
-
}
while (dwBytesToWrite >
0);
-
-
CloseHandle(pFile);
-
-
return
TRUE;
-
}