网络安全编程：文件相关操作API函数

 [[381235]]

刚开始接触编程可能会觉得Windows API是一个很神奇、很万能的工具，Windows API是Windows下开发应用程序的基础知识，不过基础并不代表简单，能掌握好Windows API来开发程序也是非常不容易的。

在Windows下，文件有很多种，比如图片文件、视频文件、音频文件……这些文件都属于保存在磁盘上的存储格式不相同的文件。除了常见的磁盘文件格式外，管道、邮槽，甚至是设备对象，在Windows下也都被当作文件来对待。这样在编程的过程中，操作管道、邮槽、设备对象就如同操作文件一样。

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()函数使用的文件名进行操作的，如果文件被打开以后，又怎么能删除呢？

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

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函数。