文件读写（Windows API）--ReadFile、WriteFile

函数原型

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，则函数调用失败。