3.1.1 文件相关操作API函数

1．文件的打开与关闭

要对文件进行操作，首先把要操作的文件打开，文件打开成功后会返回一个可以用于操作文件的句柄，通过这个句柄就可以对文件进行读写操作了。

打开文件的API函数定义如下：

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

参数说明如下：

lpFileName：欲打开或创建的文件名，这里也可以不是文件名，可以是设备对象之类的被视为文件的相关对象。

dwDesiredAccess：对文件的访问模式，它指定了要对打开的对象进行何种操作。通常是GENERIC_READ和GENERIC_WRITE，分别表示只读模式和只写模式；还可以通过按位或运算符同时指定两种模式，如GENERIC_READ | GENERIC_WRITE。

dwShareMode：打开文件的共享模式，表示文件被打开后是否允许其他进程进行操作，如果可以进行操作，可以指定其操作的模式。

lpSecurityAttributes：该参数表示安全属性，通过这个参数可以指定返回的文件句柄是否可以被子进程继承，如果参数设置为NULL，表明无法被继承，否则需要将参数指向一个SECURITY_ATTRIBUTES的结构体。该参数通常为NULL。

dwCreationDisposition：在创建或打开的文件存在或不存在时该函数的处理方式。

dwFlagsAndAttributes：该参数用来指定新建文件的属性和对文件操作的方式。

hTemplateFile：文件模板句柄，系统会复制该文件模板的所有属性到当前创建的文件中。

该函数若执行成功，则返回一个文件句柄；如果执行失败，则返回INVALID_HANDLE_VALUE。具体失败的原因可以通过调用GetLastError()函数来得到。

文件的打开操作调用的是CreateFile()函数，该函数名不像其名字那样只能用于创建文件。CreateFile()函数既可以打开文件，也可以创建文件。在Windows下有一个OpenFile()函数用来打开文件，不过它是Win16的产物，在Win32下必须使用CreateFile()来打开文件。

CreateFile()的参数很多，不过用习惯后会发现常用的参数都很容易记住，甚至有些参数常用的就是那么一两个。在对文件操作完成后，需要对打开文件的句柄进行关闭以释放资源。关闭对象句柄的函数非常简单，而且使用也非常广泛。该函数的定义如下：

        BOOL CloseHandle(
          HANDLE hObject    // handle to object
        );

该函数的参数只有一个，这个参数就是调用CreateFile()函数时的返回值，也就是文件句柄。该函数并不仅仅能够关闭文件句柄，事件句柄、进程句柄、线程句柄等一系列对象句柄都可以用该函数进行关闭。

2．文件的操作

文件的操作有4种，分别是“增、删、改、查”。接触过数据库的读者一定感觉这些操作都是针对数据库的，怎么对文件的操作也是这4种呢？其实，不单单是对文件的操作存在增、删、改、查，对注册表、系统服务、进程等的操作也都存在增、删、改、查。只不过相对应的有不同的Windows API函数，而不是使用数据库的SQL语句而已。

用文件的操作进行举例说明。文件的“增”操作可以理解为创建文件，文件的“删”操作可以理解为删除文件，文件的“改”操作可以理解为对文件的写操作，文件的“查”操作可以理解为对文件的“读”操作。

对于文件的读写操作可以从狭义和广义上进行认识，狭义的“读文件”就是读取已打开文件的内容或数据，而广义的“读文件”则可以是获取文件的大小、创建时间和修改时间等，因为文件的大小、创建时间、修改时间也属于文件的属性，只是这些属性不保存在本身的文件中。写操作也是同样的道理。

下面将介绍常用的文件的删除操作、读写操作所涉及的API函数，具体的更多涉及文件操作的函数无法一一介绍，靠读者自行积累总结。

删除文件的API函数定义如下：

        BOOL DeleteFile(
          LPCTSTR lpFileName
        );

该函数的参数只有一个，lpFileName表示要删除的文件的文件名。大部分的文件操作函数都是通过CreateFile()函数返回的文件句柄进行操作，而DeleteFile()函数使用的文件名进行操作的，如果文件被打开以后，又怎么能删除呢？

读取文件内容的函数如下：

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

参数说明如下。

hFile：文件句柄，通常是CreateFile()函数返回的句柄。

lpBuffer：指向一个缓冲区，函数会将从文件中读出的数据保存在该缓冲区中。

nNumberOfBytesToRead：要求读入的字节数，通常情况下是缓冲区的大小。

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

lpOverlapped：一般设置为NULL。

写入文件内容的函数如下：

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

WriteFile()函数的参数和ReadFile()函数的参数意义基本相同，所不同的是第2个参数。第2个参数仍然指向一个缓冲区，WriteFile()函数会将该缓冲区的内容进行写入。当用WriteFile()函数写文件时，写入的数据通常被Windows暂时保存在内部的高速缓存中，操作系统会定期进行盘写入，从而避免频繁进行I/O操作影响执行效率。为了保证数据即时写入可以使用FlushFileBuffers()函数，该函数的定义如下：

        BOOL FlushFileBuffers(
          HANDLE hFile
        );

该函数会将指定文件句柄的缓冲区进行清空，使得Windows将缓冲区中的文件写入磁盘。该函数只有一个参数，即文件句柄。该文件句柄与ReadFile()和WriteFile()所使用的文件句柄相同。

在进行文件读写时，往往并不是由前往后顺序读写，通常是根据需要读写文件的某个部分，这就需要对文件指针进行移动，从而正确对文件进行读写操作。移动文件指针的函数定义如下：

        DWORD SetFilePointer(
          HANDLE hFile,
          LONG lDistanceToMove,
          PLONG lpDistanceToMoveHigh,
          DWORD dwMoveMethod
        );

该函数的参数说明如下。

hFile：进行文件操作时的文件句柄，如同ReadFile()和WriteFile()。

lDistanceToMove：指定要移动文件指针的距离。

lpDistanceToMoveHigh：一个指向LONG型的指针，移动距离的高32位，一般为NULL。

dwMoveMethod：指定移动的起始位置。可以从文件开始位置进行移动（FILE_BEGIN），可以从当前文件位置开始移动（FILE_CURRENT），也可以从文件的末尾开始移动（FILE_END）。

3．驱动器及目录相关操作

前面介绍了文件相关的操作。本节介绍目录相关的操作，主要介绍4个相关函数，分别是获取本地所有逻辑驱动器、获取驱动器类型、创建目录和移除目录。下面介绍这4个函数的定义。

获取本地所有逻辑驱动器函数的定义如下：

        DWORD GetLogicalDriveStrings(
          DWORD nBufferLength,
          LPTSTR lpBuffer
        );

该函数的参数说明如下。

nBufferLength：表示lpBuffer的长度。

lpBuffer：表示接收本地逻辑驱动器名的缓冲区。

该函数以字符串的形式返回本地所有可用的驱动器名保存在lpBuffer中。返回字符串的形式如“C:\”，0，“D:\”，0，“E:\”，0，0。

获取驱动器类型函数的定义如下：

        UINT GetDriveType(
          LPCTSTR lpRootPathName
        );

该函数只有一个参数lpRootPathName，要获取逻辑驱动器类型的驱动器名，如“C：\”。函数返回值取以下值之一。

        DRIVE_UNKNOWN：       无法识别此驱动器类型；
        DRIVE_NO_ROOT_DIR：  无效的驱动器路径；
        DRIVE_REMOVEABLE：   可移动驱动器，如U盘、移动硬盘等；
        DRIVE_FIXED：         不可移动驱动器，指硬盘；
        DRIVE_REMOTE：        网络驱动器；
        DRIVE_CDROM：         光盘驱动器；
        DRIVE_RAMDISK：       虚拟驱动器。

创建目录的函数定义如下：

        BOOL CreateDirectory(
          LPCTSTR lpPathName,
          LPSECURITY_ATTRIBUTES lpSecurityAttributes
        );

该函数的参数说明如下。

lpPathName：创建目录的目录名称。

lpSecurityAttributes：安全属性，一般设置为NULL。

移除目录的函数定义如下：

        BOOL RemoveDirectory(
          LPCTSTR lpPathName
        );

该函数的参数指定要移除的目录的目录名。

以上是关于驱动器和目录的几个常用的API函数，下一小节会使用前面所学的API函数来完成一个简单说实例。