美文网首页
文件读写(Windows API)--ReadFile、Writ

文件读写(Windows API)--ReadFile、Writ

作者: 7bfedbe4863a | 来源:发表于2018-01-17 00:03 被阅读0次
    函数原型
    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,则函数调用失败。

    相关文章

      网友评论

          本文标题:文件读写(Windows API)--ReadFile、Writ

          本文链接:https://www.haomeiwen.com/subject/fiaeoxtx.html