<Win32 API> 文件操作CreateFile/ReadFile/WriteFile

1. CreateFile/ReadFile/WriteFile

CreateFile函数原型：

HANDLE CreateFile(
  LPCTSTR lpFileName,
  DWORD dwDesiredAccess,
  DWORD dwShareMode,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  DWORD dwCreationDisposition,
  DWORD dwFlagsAndAttributes,
  HANDLE hTemplateFile
);

lpFileName: 以'\0'结尾的文件、COM口等路径，如果是文件，可以是完整路径也可以是相对路径。

dwDesiredAccess: 访问文件的想要获取的权限，多个使用则使用“|”相连：

    GENERIC_EXECUTE：执行的权限，如Linux里面的-x

    GENERIC_READ：读的权限，如Linux里面的-r

    GENERIC_WRITE：写的权限，如Linux里面的-w

dwSharMode：共享模式, 设为

    0，则是不共享

    FILE_SHARE_READ: 共享读

    FILE_SHARE_WRITE：共享写

lpSecurityAttributes: 未使用

dwCreationDisposition: 文件不存在的时候的创建选项，如fopen里面的 “r", "w", "b"等。

   CREATE_ALWAYS：总是创建，不存在则创建，存在则覆盖，原文件内容丢失；

   OPEN_EXISTING：文件一定要存在，否则失败

   CREATE_NEW：不存在则创建，存在则不创建并返回失败

   OPEN_ALWAYS：如果存在则打开文件，不存在则创建文件

   TRUNCATE_EXISTING：如果存在则打开文件并清空文件内容，至少要求GENERIC_WRITE权限，不存在则返回失败；

dwFlagsAndAttributes: 文件的属性

   FILE_ATTRIBUTE_NORMAL：默认属性，没有被设置属性

   FILE_ATTRIBUTE_READONLY：只读文件

   FILE_ATTRIBUTE_HIDDEN：隐藏文件

   具体查看官方API

hTemplateFile: 忽略

返回值：INVALID_HANDLE_VALUE, 失败，其他有效句柄则是成功，打开的句柄需要使用CloseHandle关闭。

ReadFile函数原型:

BOOL ReadFile(
  HANDLE hFile,
  LPVOID lpBuffer,
  DWORD nNumberOfBytesToRead,
  LPDWORD lpNumberOfBytesRead,
  LPOVERLAPPED lpOverlapped
);

hFile：文件句柄

lpBuffer: 存放数据的缓冲区

nNumberOfBytesToRead: 预设读取字节数

lpNumberOfBytesRead: 实际读取字节数

lpOverlapped: 不支持，设为NULL

返回值：0：失败，非0，成功。

如果返回非0，而lpNumberOfBytesRead所指向的值是0，则表示文件指针已经超出了文件范围。

WriteFile函数原型：

BOOL WriteFile( 
  HANDLE hFile, 
  LPCVOID lpBuffer, 
  DWORD nNumberOfBytesToWrite, 
  LPDWORD lpNumberOfBytesWritten, 
  LPOVERLAPPED lpOverlapped
); 

参照 ReadFile既可。

2. 文件/文件夹操作

CopyFile:复制文件

DeleteFile:删除文件

CreateDirectory:创建文件夹

RemoveDirectory: 删除文件夹

3. 测试代码

//
// Win32 文件操作
void TestCreateFile()
{
	// 创建文件
	HANDLE hFile = CreateFile(TEXT("test.txt"),  // 在当前文件夹创建test.txt文件
					GENERIC_WRITE, 0, NULL,
					CREATE_NEW, FILE_ATTRIBUTE_NORMAL, 0);

	if (INVALID_HANDLE_VALUE == hFile)	// 判断文件是否创建成功
	{
		cout << "创建文件失败" << endl;
		return;
	}

	DWORD dwBytesWriten = 0;
	char buffer[50] = {"my test string"};
	int nRet = WriteFile(hFile, buffer, strlen(buffer), &dwBytesWriten, NULL);

	cout << "WriteFile返回值：" << nRet << endl;
	cout << "实际写入的字节数：" << dwBytesWriten << endl;

	CloseHandle(hFile);

	// 读取文件
	hFile = CreateFile(TEXT("test.txt"), 
				GENERIC_READ, 0, NULL, 
				OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0);
	if (INVALID_HANDLE_VALUE == hFile)	// 判断文件是否创建成功
	{
		cout << "打开文件失败" << endl;
		return;
	}
	DWORD dwBytesRead = 0;
	memset(buffer, 0, 50);
	nRet = ReadFile(hFile, buffer, 50, &dwBytesRead, NULL);

	cout << "ReadFile返回值： " << nRet << endl;
	cout << "实际读取的字节数：" << dwBytesRead << endl;
	cout << "读取到的字符： " << buffer << endl;

	CloseHandle(hFile);
}

运行结果：