windows 文件操作

Windows提供了一类API来读、写和管理磁盘文件。

使用API函数读写文件时，首先要使用CreateFile函数创建文件对象，调用成功会返回文件句柄。我们以此句柄为参数调用ReadFile和WriteFile函数，进行实际的读写操作；最后调用CloseHandle函数关闭不再使用的文件对象句柄。

 

1）打开和关闭文件：

CreateFile是一个功能强大的函数，Windows下的底层设备几乎都由它打开。它可以创建或打开文件、目录、物理磁盘、控制台缓冲区、油槽或管道等：

HANDLE CreateFile(

         LPCTSTR lpFileName,  //要创建或打开的对象的名称

         DWORD dwDesiredAccess, //文件的存取方式

         DWORD dwShareMode,               //共享属性

         LPSECURITY_ATTRIBUTES lpSecurityAttributes,      //安全属性

         DWORD dwCreationDisposition,                //文件存在或不存在时系统采取的行动

         DWORD dwFlagsAndAttributes,         //新文件的属性

         HANDLE hTemplateFile       //一个文件模板的句柄

         );

lpFileName—如果是打开文件，直接指定文件名称即可；如果操作对象是第一个串口，则指定“COM1”为文件名，然后就可以像操作文件一样操作串口了；如果要打开本地电脑上的一个服务，要以//./服务名称为文件名，其中”.”代表本地机器；如果要打开网络中其他主机的文件，则以//主机名/共享目录名/文件名为文件名。

dwDesiredAccess—GENERIC_READ(只读)、GENERIC_WRITE(只写)、两者组合。

dwShareMode—表示文件打开后是否允许其他代码以某种方式再次打开这个文件，可以是下面的组合：

         0—不允许文件再被打开。C语言中的fopen函数就是这种方式；

         FILE_SHARE_DELETE—允许其他程序代码删除文件；

         FILE_SHARE_READ—允许其他程序代码以读方式打开文件；

         FILE_SHARE_WRITE—允许其他程序代码以写方式打开文件；

dwCreationDisposition—指定当文件已存在或不存在时系统采取的动作：

         CREATE_ALWAYS—创建新文件，若文件存在，则覆盖它，清除存在的属性；

         CREATE_NEW—创建新文件。若文件存在，函数执行失败；

         OPEN_ALWAYS—如果文件存在则打开它，不存在则创建新文件；

         OPEN_EXISTING—打开存在的文件。若文件不存在，函数执行失败；

         TRUNCATE_EXISTING—打开文件并将文件截断为0，当文件不存在时函数执行失败。

dwFlagsAndAttributes—指定新建文件属性和标志，可以是以下各项的组合：

         FILE_ATTRIBUTE_ARCHIVE—标记归档属性；

         FILE_ATTRIBUTE_HIDDEN—标记隐藏属性；

         FILE_ATTRIBUTE_READONLY—标记只读属性；

         FILE_ATTRIBUTE_SYSTEM—标记系统属性；

                FILE_ATTRIBUTE_TEMPORARY—临时文件，操作系统会尽量把所有文件的内容保持在内存中以加快存取速度。使用完后要尽快将它删除。

         FILE_FLAG_DELETE_ON_CLOSE—文件关闭后系统立即自动删除它；

         FILE_FLAG_OVERLAPPED—使用异步读写文件的方式；

         FILE_FLAG_WRITE_THROUGH—系统不会对文件使用缓冲，文件的任何改变都会被系统立即写入硬盘。

hTemplateFile—指定一个文件模板句柄。系统会复制文件模板的所有属性到当前创建的文件中。

 

打开或创建文件成功时，函数返回文件句柄，失败时返回INVALID_HANDLE_VALUE。

 

2）移动文件指针：

SetFilePointer函数：系统为每个打开的文件维护一个文件指针，指定对文件的下一个读写操作从什么位置开始。随着数据的读出或写入，文件指针也随之移动。当文件刚被打开时，文件指针处于文件的头部。有时候需要随机读取文件内容，这就需要先调整文件指针：

DWORD SetFilePointer(

         HANDLE hFile,                //文件句柄

         LONG lDistanceToMove,    //要移动的距离

         PLONG lpDistanceToMoveHigh,        //移动距离的高32位，一般位置为NULL

         DWORD dwMoveMethod           //移动的模式

         );

dwMoveMethod参数指明从什么地方开始移动：

         FILE_BEGIN—开始移动的位置为0，即从文件头部开始移动；

         FILE_CURRENT—开始移动位置是文件指针的当前值；

         FILE_END—开始移动位置是文件的结尾，即从文件尾开始移动。

文件指针也可以移动到所有数据后面，比如现在文件长度是200KB，但可以成功地将文件指针移动到1000KB的位置。这样做可以达到扩展文件长度的目的。

SetEndOfFile函数就可以达到截断或者扩展文件的功能。该函数移动指定文件的结束标志（EOF）到文件指针指向的位置。如果文件扩展，旧的EOF位置和新的EOF位置间的内容是未定义的：

BOOL SetEndOfFile(HANDLE hFile);

截断或者扩展文件时，要首先调用SetFilePointer移动文件指针，然后再调用SetFilePointer函数设置新的文件指针位置为EOF。

 

3）读写文件：

ReadFile和WriteFile函数既可以同步读写文件，也可以异步读写文件；而函数ReadFileEx和WriteFileEx只能异步读写文件。

BOOL ReadFile(

         HANDLE hFile,                //文件句柄

         LPVOID lpBuffer,  //指向一个缓冲区，函数会将读出的数据返回到这里

         DWORD nNumberOfBytesToRead,   //要求读入的字节数

         LPDWORD lpNumberOfBytesRead,  //指向一个DWORD类型的变量，用于返回实际读入的字节数

         LPOVERLAPPED lpOverlapped  //一般设为NULL

         );

 

BOOL WriteFile(

         HANDLE hFile,                //文件句柄

         LPVOID lpBuffer,  //指向一个缓冲区，包含了要写入文件的数据

         DWORD nNumberOfBytesToWrite, //要求写入的字节数

         LPDWORD lpNumberOfBytesWritten,     //指向一个DWORD类型的变量，用于返回实际写入的字节数

         LPOVERLAPPED lpOverlapped  //一般设为NULL

         );

使用WriteFile写文件时，写入的数据通常被Windows暂存在内部的高速缓存中，等合适的时候再一并写入磁盘。可以使用FlushFileBuffers函数来强制系统清空缓冲区：

BOOL FlushFileBuffers(HANDLE hFile);

 

4）锁定文件：

当我们对文件数据的一致性要求较高时，为了防止程序在写入过程中其他进程刚好在读取写入区域的数据，可以对已打开文件的某个部分加锁，加锁和解锁的函数分别是LockFile和UnlockFile：

BOOL LockFile(

         HANDLE hFile,       //文件句柄

         DWORD dwFileOffsetLow,         //加锁的开始位置

         DWORD dwFileOffsetHigh,

         DWORD nNumberOfBytesToLockLow,    //加锁区域的大小

         DWORD nNumberOfBytesToLockHigh

         );

 

BOOL UnlockFile(

         HANDLE hFile,       //文件句柄

         DWORD dwFileOffsetLow,         //解锁的开始位置

         DWORD dwFileOffsetHigh,

         DWORD nNumberOfBytesToLockLow, //解锁区域的大小

         DWORD nNumberOfBytesToLockHigh

         );

 

5）获取文件类型：

Windows下许多对象都称为文件，如果想知道一个文件句柄到底是什么对象，可是使用函数GetFileType：

DWORD GetFileType(HANDLE hFile);

返回值如下：

FILE_TYPE_CHAR---指定文件时字符文件，通常是LPT设备或控制台；

FILE_TYPE_DISK---指定文件时磁盘文件；

FILE_TYPE_PIPE---指定文件是套接字，一个命名的或未命名的管道；

FILE_TYPE_UNKNOWN—不能识别指定文件，或者函数调用失败。

 

获取文件大小：

如果确定操作的对象时磁盘文件，可以使用GetFileSize函数取得这个文件的长度：

DWORD GetFileSize(

         HANDLE hFile,                //文件句柄

         LPDWORD lpFileSizeHigh   //用于返回文件长度的高字节，可以指定这个参数为NULL

         );

函数执行成功将返回文件大小的低双字，如果lpFileSizeHigh不为NULL，函数将文件大小的高双字放入它指向的DWORD变量中。

如果返回值是INVALID_FILE_SIZE，应用程序必须调用GetLastError来确定函数调用是否成功。因为当lpFileSizeHigh不为NULL或者文件大小为oxffffffff时，函数虽然调用成功，但依然会返回INVALID_FILE_SIZE，这种情况下，GetLastError会返回NO_ERROR来响应成功。

 

6）获取文件属性：

如果要查看文件或者目录的属性，可以使用GetFileAttributes函数，它返回一系列FAT风格的属性信息：

DWORD GetFileAttributes(LPCTSTR lpFileName); //lpFileName指定了文件或者目录的名称

返回值是下列各项的组合：

FILE_ATTRIBUTE_ARCHIVE

FILE_ATTRIBUTE_COMPRESSED

FILE_ATTRIBUTE_DIRECTORY

FILE_ATTRIBUTE_HIDDEN

FILE_ATTRIBUTE_NORMAL

FILE_ATTRIBUTE_READONLY

FILE_ATTRIBUTE_SYSTEM

FILE_ATTRIBUTE_TEMPORARY

这些属性对目录同样适用，函数执行失败返回INVALID_FILE_ATTRIBUTES。

设置文件属性的函数是SetFileAttributes：

BOOL SetFileAttributes(

         LPCTSTR lpFileName,            //目标文件名称

         DWORD dwFileAttributes  //要设置的属性值

         );

下面是快速检查某个文件或目录是否存在的自定义函数：

BOOL FileExists(LPCTSTR lpszFileName, BOOL bIsDirCheck)

{

         //取得文件的属性

         DWORD dwAttributes = GetFileAttributes(lpszFileName);

         if(dwAttributes == INVALID_FILE_ATTRIBUTES)

         {

                   return FALSE;

         }

         if((dwAttributes & FILE_ATTRIBUTE_DIRECTORY) == FILE_ATTRIBUTE_DIRECTORY)

         {

                   if(bIsDirCheck)       //检查目录

                            return TRUE;

                   else

                            return FALSE;

         }

         else

         {

                   if(!bIsDirCheck) //检查文件

                            return TRUE;

                   else

                            return FALSE;

         }

}

 

7）拷贝文件：

函数CopyFile和CopyFileEx的作用是复制一个存在的文件到一个新文件中：

BOOL CopyFile(

         LPCTSTR lpExistingFileName,     //指定已存在的文件的名称

         LPCTSTR lpNewFileName,  //指定新文件的名称

         BOOL bFailIfExists                  //如果指定的新文件存在是否按出错处理

         );

CopyFileEx函数的附加功能是允许指定一个回调函数，在拷贝过程中，函数每拷贝完一部分数据，就会调用回调函数。用户在回调函数中可以指定是否停止拷贝，还可以显示进度条来指示拷贝的进度。

 

8）删除文件：

BOOL DeleteFile(LPCTSTR lpFileName);

用DeleteFile函数删除的文件不会被放进回收站，它们将永远丢失。

自定义函数RecursiveDelete用于删除指定目录下所有的文件和子目录：

void RecursiveDelete(CString szPath)

{

         CFileFind ff;    //MFC将查找文件的API封装到了CFileFind类中

         CString strPath = szPath;

         //说明要查找此目录下的所有文件

         if(strPath.Right(1) != "//")

                   strPath += "//";

         strPath += "*.*";

         BOOL bRet;

         if(ff.FindFile(strPath))

         {

                   do

                   {

                            bRet = ff.FindNextFile();

                            if(ff.IsDots())  //目录为"."或者".."

                                     continue;

                            strPath = ff.GetFilePath();

                            if(!ff.IsDirectory()) //是文件了

                            {

                                     //删除此文件

                                     ::SetFileAttributes(strPath, FILE_ATTRIBUTE_NORMAL);

                                     ::DeleteFile(strPath);   

                            }

                            else  //还是目录

                            {       

                                     //递归调用

                                     RecursiveDelete(strPath);

                                     //删除此目录(RemoveDirectory只能删除空目录)

                                     ::SetFileAttributes(strPath, FILE_ATTRIBUTE_NORMAL);

                                     ::RemoveDirectory(strPath);

                            }

                   }while(bRet);         

         }

}

 

9）移动文件：

函数MoveFile和MoveFileEx的功能是移动一个存在的文件或目录：

BOOL MoveFile(

       LPCTSTR lpExistingFileName, //存在的文件或目录

       LPCTSTR lpNewFileName      //新的文件或目录

       );           

当需要指定如何移动文件时，使用MoveFileEx：

BOOL MoveFileEx(

       LPCTSTR lpExistingFileName, //存在的文件或目录

       LPCTSTR lpNewFileName,     //新的文件或目录

       DWORD dwFlags

       );           

dwFlags参数是下列值的组合：

MOVEFILE_DELAY_UNTIL_REBOOT—函数并不立即执行，而是在操作系统下一次重启时才移动此文件。在AUTOCHK执行之后，系统立即移动文件，这是在创建任何分页文件之前进行的。因此，这个值能够使函数删除上一次运行时使用的分页文件。

MOVEFILE_REPLACE_EXISTING—如果目标文件已存在的话，就将它替换掉；

MOVEFILE_WRITE_THROUGH—直到文件实际从磁盘移除之后函数才返回。