文件读写(Windows API)--ReadFile、Writ
2018-01-17 本文已影响0人
7bfedbe4863a
函数原型
BOOL ReadFile(
HANDLE hFile, //文件的句柄
LPVOID lpBuffer //用于保存读入数据的一个缓冲区
DWORD nNumberOfBytesToRead, //要读入的字节数
LPDWORD lpNumberOfBytesRead, //指向实际读取字节数的指针
LPOVERLAPPED lpOverlapped
//如文件打开时指定了FILE_FLAG_OVERLAPPED,那么必须,用这个参数引用一个特殊的结构。
//该结构定义了一次异步读取操作。否则,应将这个参数设为NULL
//(暂时不看异步读取,只看基本的话,用NULL就好了)
);
示例
DWORD RSize;
m_hFile = (HANDLE)CreateFile(m_strFileName, GENERIC_WRITE, FILE_SHARE_READ, NULL, OPEN_EXISTING, NULL, NULL);
if (m_hFile == INVALID_HANDLE_VALUE)
{
m_hFile = NULL;
MessageBoxA(NULL, "Can not open file!", "Error", MB_OK);
}
ReadFile(m_hFile, pBuffer, GetFileSize(m_hFile, NULL), &RSize, NULL);
CloseHandle(m_hFile); //使用完要关闭文件句柄
//m_hFile是打开的文件的句柄
//pBuffer中存储读取到的数据
参数说明
- HANDLE hFile, 需要读入数据的文件指针,这个指针指向的文件必须是GENERIC_READ 访问属性的文件。
- LPVOID lpBuffer,接收数据的缓冲区。
- DWORD nNumberOfBytesToRead,指定要读取的字节数。
- LPDWORD lpNumberOfBytesRead,指向一个DWORD类型变量的指针,用来接收读取的字节数。TODO:如果下一个参数为NULL,那么一定要传入这个参数???我在用的时候给它传了NULL也可以?
- LPOVERLAPPED lpOverlapped, OVERLAPPED结构体指针,如果文件是以FILE_FLAG_OVERLAPPED方式打开的话,那么这个指针就不能为NULL。FILE_FLAG_OVERLAPPED 允许对文件进行重叠操作
返回值
调用成功,返回非0
调用不成功,返回为0。会设置GetLastError。
WriteFile
函数原型
BOOL WriteFile(
HANDLE hFile,//文件句柄
LPCVOID lpBuffer,//数据缓存区指针
DWORD nNumberOfBytesToWrite,//要写的字节数
LPDWORD lpNumberOfBytesWritten,//用于保存实际写入字节数的存储区域的指针
LPOVERLAPPED lpOverlapped//OVERLAPPED结构体指针
);
- 用法和参数可以参照上面的ReadFile的说明。
- 在使用这个函数的时候,它打开的文件的句柄一定要有写的权限。
- 如果用和上面的示例那个调用函数一样的参数来调用WriteFile函数的话,是把数据添加到文件的末尾处。
GetFileSize
函数原型
DWORD WINAPI GetFileSize(
HANDLE hFile,
LPDWORD lpFileSizeHigh
);
参数
- hFile:文件句柄。
- lpFileSizeHigh:指向高阶双字的文件大小的指针,此参数可以为NULL。(不为空的暂时没用到,用到的时候再补)
返回值
- 如果函数调用成功,则返回值为文件大小的低位双字,lpFileSizeHigh返回文件大小的高阶双字。
- 如果函数返回值为INVALID_FILE_SIZE,并且GetLastError函数返回值非NO_ERROR,则函数调用失败。