《精通Windows API-函数、接口、编程实例》——第4章文件系统

最新推荐文章于 2023-12-26 09:00:00 发布

xushuangjay

最新推荐文章于 2023-12-26 09:00:00 发布

阅读量6k

点赞数

分类专栏：精通Windows API-函数、接口、编程实例文章标签： windows 编程 file api null 磁盘

精通Windows API-函数、接口、编程实例专栏收录该内容

1 篇文章 0 订阅

订阅专栏

第4章文件系统

4.2 磁盘和驱动器管理

文件系统的基本概念:
包括磁盘分区,卷,目录,文件对象,文件句柄,文件映射
1.磁盘分区:
物理磁盘,逻辑磁盘
2.卷:
也称逻辑驱动器，是NTFS,FAT32等文件系统组织结构的最高层.
卷是存储设备(硬盘)上由文件系统管理的一块区域，在逻辑上相互隔离的存储单元.

windows命名规则:
主文件名+扩展名
windows中文件系统的长度被限制为260个字符.
这260个字符包括卷标,路径,主文件名和扩展名,分隔符

在DOS下的保留设备名不能做文件名或主文件名.如CON,PRN,AUX,NUL,COM1.....

=================================================================

磁盘和驱动器管理API
GetLogicalDrivers       获取主机中所有的逻辑驱动器,以Bit Map的形式返回.
GetLogicalDriverString    获取主机中所有的逻辑驱动器,以驱动器根路径字符串返回.
FindFirstVolume     查找主机中的第一个驱动器，返回查找句柄.
FindNextVolume      根据FindFirstVolume返回句柄,查找主机中后继的逻辑驱动器
FindVolumeClose     关闭驱动器查找句柄
GetDriveType      获取驱动器类型
GetVolumeInformation    获取逻辑驱动器信息
FindFirstVolumeMountPoint 查找指定卷的第一个挂载点,返回查找句柄
FindNextVolumeMountPoint 根据FindFirstVolumeMountPoint返回的句柄,查找卷的后继挂载点.
FindVolumeMountPointClose 关闭挂载点查找句柄
GetVolumeNameForVolumeMountPoint 根据指定挂载点获取相应的卷设备名
SetVolumeMountPoint         将指定卷挂载到指定挂载点处
GetDiskFreeSpace            获取磁盘空间信息,包括每簇的扇区数,每扇区的字节数,簇数量,空闲的簇数量
GetDiskFreeSpaceEx          获取用户可用的空闲空间的字节数,磁盘总容量的字节数

文件和目录管理API
DeleteFile                  删除参数所指定文件
CopyFile                    复制指定文件为一个新文件
MoveFile                    将指定文件或目录移动到指定位置
CreateFile                  新建或打开一个文件,获取文件句柄
ReadFile                    读取由文件句柄指定文件的内容
WriteFile                   向由文件句柄指定的文件中写入内容
GetFileSize                 获取文件大小,返回DWORD中;大小超出DWORD最大值时可指定高32位的DWORD联合存储
GetFileSizeEx               获取文件大小,存储到一个64位的大整数联合体中.
CreateDirectory             创建一个目录
GetCurrentDirectory         获取当前程序所在目录
SetCurrentDirectory         设置当前程序所在目录
GetModuleFileName           获取当前模块全路径
FindFirstFile               查找指定目录下第一个文件句柄或目录,获得查找句柄
FindNextFile                根据FindFirstFile获得的句柄,循环查找文件或目录
GetFileAttributes           获取指定文件目录属性,返回一个DWORD值
GetFileAttributesEx         获取文件或目录属性,存储在WIN32_FILE_ATTRIBUTE_DATA结构体中
SetFileAttributes           将文件属性设定为指定值
FileTimeToLocalFileTime     将文件时间转换为本地时间
FileTimeToSystemTime        将文件转换为系统时间,SYSTEMTIME格式便于显示

高级文件操作
CreateFileMapping           创建文件的映射对象
MapViewOfFile               创建视图,将创建的文件映射对象映射到当前进程的地址空间中
FlushViewOfFile             将视图中的数据都写入磁盘,对视图的操作都会反映到磁盘上的文件中
OpenFileMapping             打开已经存在的命名的文件映射对象
UnmapViewOfFile             取消文件映射
GetMappedFileName           从映射对象获取被映射文件的文件设备名
QueryDosDevice              获取MS-DOS设备名

=================================================================

2 磁盘和驱动器管理

◇使用两种方法来遍历驱动器并获取驱动器属性。
◇使用API操作驱动器挂载点。
◇判断光驱中是否有光盘。
◇获取磁盘剩余空间、扇区信息等。

4.2.1 遍历卷并获取属性

用到的API函数：

(1) GetLogicalDrives。
获取主机中所有的逻辑驱动器，以BitMap的形式返回，其函数原型如下：

(2) GetLogicalDriverStrings。
获取主机中所有驱动器，以驱动器根路径字符串返回，其函数原型如下：

（3）FindFirstVolume。
查找主机中的第一个驱动器，返回驱动器设备名，其函数原型如下：

（4）FindNextVolume
查找主机中后继的逻辑驱动器，其函数原型如下：

(5）FindVo1umeClose。
＼关闭FindFirstVolume打开的卷遍历句柄，其函数原型如下：

(6) GetDriveType。
获取驱动器类型，其函数原型如下：

(7) GetVolumeInformation。
获取逻辑驱动器信息，其函数原型如下：

/* ************************************ *《精通Windows API》 * 示例代码 * GetVolumeInfo.c * 4.2.1 遍历驱动器并获取驱动器属性 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdlib.h> #include <stdio.h> #include <string.h> /* 预定义　*/ #define BUFSIZE 1024 /* 函数申明　*/ BOOL GetDirverInfo(LPSTR szDrive); /* ************************************ * 功能应用程序主函数，遍历驱动器并调用 * GetDirverInfo 获取驱动器属性 **************************************/ void main(void) { CHAR szLogicalDriveStrings[BUFSIZE]; PCHAR szDrive; ZeroMemory(szLogicalDriveStrings,BUFSIZE); // 获取逻辑驱动器卷标名 GetLogicalDriveStrings(BUFSIZE - 1,szLogicalDriveStrings); szDrive = (PCHAR)szLogicalDriveStrings; // 循环处理每个卷 do { if(!GetDirverInfo(szDrive)) { printf("/nGet Volume Information Error: %d", GetLastError()); } szDrive += (lstrlen(szDrive)+1); } while(*szDrive!='/x00'); } /* ************************************ * BOOL GetDirverInfo(LPSTR szDrive) * 功能获取驱动器的属性 * 参数 LPSTR szDrive * 指明要获取属性的驱动器的根路径如 C:/ * 返回值 BOOL 是否成功 **************************************/ BOOL GetDirverInfo(LPSTR szDrive) { UINT uDriveType; DWORD dwVolumeSerialNumber; DWORD dwMaximumComponentLength; DWORD dwFileSystemFlags; TCHAR szFileSystemNameBuffer[BUFSIZE]; printf("/n%s/n",szDrive); uDriveType = GetDriveType(szDrive); // 判断类型 switch(uDriveType) { case DRIVE_UNKNOWN: printf("The drive type cannot be determined. 未知的磁盘类型 "); break; case DRIVE_NO_ROOT_DIR: printf("The root path is invalid, for example, no volume is mounted at the path. 说明lpRootPathName是无效的 "); break; case DRIVE_REMOVABLE: printf("The drive is a type that has removable media, for example, a floppy drive or removable hard disk. 可移动磁盘 "); break; case DRIVE_FIXED: printf("The drive is a type that cannot be removed, for example, a fixed hard drive. 固定磁盘 "); break; case DRIVE_REMOTE: printf("The drive is a remote (network) drive. 网络磁盘 "); break; case DRIVE_CDROM: printf("The drive is a CD-ROM drive. 光驱 "); break; case DRIVE_RAMDISK: printf("The drive is a RAM disk. "); break; default: break; } if (!GetVolumeInformation( szDrive, NULL, 0, &dwVolumeSerialNumber, &dwMaximumComponentLength, &dwFileSystemFlags, szFileSystemNameBuffer, BUFSIZE )) { return FALSE; } printf ("/nVolume Serial Number is 存储驱动器序列号%u",dwVolumeSerialNumber); printf ("/nMaximum Component Length is 文件系统所支持的文件组成部分的最大值%u",dwMaximumComponentLength); printf ("/nSystem Type is文件系统类 %s/n",szFileSystemNameBuffer); if(dwFileSystemFlags & FILE_SUPPORTS_REPARSE_POINTS) { printf ("The file system does not support volume mount points./n"); } if(dwFileSystemFlags & FILE_VOLUME_QUOTAS) { printf ("The file system supports disk quotas./n"); } if(dwFileSystemFlags & FILE_CASE_SENSITIVE_SEARCH) { printf ("The file system supports case-sensitive file names./n"); } //you can use these value to get more informaion // //FILE_CASE_PRESERVED_NAMES //FILE_CASE_SENSITIVE_SEARCH //FILE_FILE_COMPRESSION //FILE_NAMED_STREAMS //FILE_PERSISTENT_ACLS //FILE_READ_ONLY_VOLUME //FILE_SUPPORTS_ENCRYPTION //FILE_SUPPORTS_OBJECT_IDS //FILE_SUPPORTS_REPARSE_POINTS //FILE_SUPPORTS_SPARSE_FILES //FILE_UNICODE_ON_DISK //FILE_VOLUME_IS_COMPRESSED //FILE_VOLUME_QUOTAS printf(".../n"); return TRUE; }

4.2.2 操作驱动器挂载点

一般可以用FindFirstVolumeMountPoint系列的API来找到一个卷的所有挂载点；用
GetVolumeNameForVolumeMountPoint来获取指定挂载点所指向的卷名，卷名形式为"//?/Volume{GUID}/”;用SetVolumeMountPoint来设置新的挂载点。
通过系统的磁盘管理功能可以设置卷的挂载点，如图4-2所示。

◇“我的电脑”图标右键菜单中选择“管理”。
◇弹出“计算机管理”窗口，选择“磁盘管理”。
◇选中需要挂载的卷，在右键菜单中选择“更改驱动器名和路径”。
◇在弹出的对话框中单击“添加”按钮，选择“装入以下空白NTFS文件夹”。
◇选择需要将卷挂载入的文件夹（空白），单击“确定”按钮。
◇卷就被装入文件夹中，之后就可以和访问文件夹一个访问这个卷了，如图4-3和4-4

(1）FindFirstVolumeMountPoint.
获取指定卷的第一个挂载点，函数原型如下：
以用GetLastError()函数获取更详细的错误信息。
(2) FindNextVolumeMountPoint
查找指定卷的后继挂载点，函数原型如下：

（3）FindVolumeMountPointClose.
关闭FindVolumeMountPointClose打开的卷句柄，其函数原型如下：
◇参数
hFindVolumeMountPoint:要关闭的挂载点查找句柄。
◇返回值
(4)GetVolumeNameForVolumeMountPoint。
根据指定的挂载点获取相应的卷设备名，函数原型如下：

（5）SetVolumeMountPc
将指定卷挂载到指定挂载点处，函数原型如下：

/* ************************************ *《Windows应用程序开发》 * 示例代码 * mount.c * 4.2.2 卷挂载点操作 **************************************/ /* 预编译声明 */ #define _WIN32_WINNT 0x0501 #include <windows.h> #include <stdio.h> #include <tchar.h> #define BUFSIZE MAX_PATH #define FILESYSNAMEBUFSIZE MAX_PATH /* ************************************ * ProcessVolumeMountPoint * 功能列举挂载点 **************************************/ BOOL ProcessVolumeMountPoint (HANDLE hPt, TCHAR *PtBuf, DWORD dwPtBufSize, TCHAR *Buf) { BOOL bFlag; // 结果 TCHAR Path[BUFSIZE]; // 全路径 TCHAR Target[BUFSIZE]; // 挂载点设备 printf ("/tVolume mount point found is /"%s/"/n", PtBuf); lstrcpy (Path, Buf); lstrcat (Path, PtBuf); bFlag = GetVolumeNameForVolumeMountPoint( Path, Target, BUFSIZE ); if (!bFlag) printf ("/tAttempt to get volume name for %s failed./n", Path); else printf ("/tTarget of the volume mount point is %s./n", Target); bFlag = FindNextVolumeMountPoint( hPt, PtBuf, dwPtBufSize ); return (bFlag); } /* ************************************ * ProcessVolume * 功能判断卷类型，列举挂载点 **************************************/ BOOL ProcessVolume (HANDLE hVol, TCHAR *Buf, DWORD iBufSize) { BOOL bFlag; // 返回标志 HANDLE hPt; // 卷句柄 TCHAR PtBuf[BUFSIZE]; // 挂载点路径 DWORD dwSysFlags; // 文件系统标记 TCHAR FileSysNameBuf[FILESYSNAMEBUFSIZE]; printf ("Volume found is /"%s/"./n", Buf); // 是否NTFS GetVolumeInformation( Buf, NULL, 0, NULL, NULL, &dwSysFlags, FileSysNameBuf, FILESYSNAMEBUFSIZE); if (! (dwSysFlags & FILE_SUPPORTS_REPARSE_POINTS)) { printf ("/tThis file system does not support volume mount points./n"); } else { // 本卷中的挂载点 hPt = FindFirstVolumeMountPoint( Buf, // 卷的跟跟踪 PtBuf, // 挂载点路径 BUFSIZE ); if (hPt == INVALID_HANDLE_VALUE) { printf ("/tNo volume mount points found!/n"); } else { // 处理挂载点 bFlag = ProcessVolumeMountPoint (hPt, PtBuf, BUFSIZE, Buf); // 循环 while (bFlag) bFlag = ProcessVolumeMountPoint (hPt, PtBuf, BUFSIZE, Buf); // 结束 FindVolumeMountPointClose(hPt); } } // 下一个 bFlag = FindNextVolume( hVol, Buf, iBufSize); return (bFlag); } /* ************************************ * int GetMountPoint(void) * 功能获取挂载点 **************************************/ int GetMountPoint(void) { TCHAR buf[BUFSIZE]; // 卷标识符 HANDLE hVol; // 卷句柄 BOOL bFlag; // 结果标志 printf("Volume mount points info of this computer:/n/n"); // 打开卷 hVol = FindFirstVolume (buf, BUFSIZE ); if (hVol == INVALID_HANDLE_VALUE) { printf ("No volumes found!/n"); return (-1); } bFlag = ProcessVolume (hVol, buf, BUFSIZE); while (bFlag) { bFlag = ProcessVolume (hVol, buf, BUFSIZE); } bFlag = FindVolumeClose( hVol ); return (bFlag); } /* ************************************ * void Usage (PCHAR argv) * 功能使用方法 **************************************/ void Usage (PCHAR argv) { printf( "/n/n/t%s, mount a volume at a mount point./n", argv ); printf( "/tFor example, /"mount D://mnt//drives// E:///"/n" ); } /* ************************************ * main * 功能入口函数 **************************************/ int main( int argc, PCHAR argv[] ) { BOOL bFlag; CHAR Buf[BUFSIZE]; if( argc != 3 ) { GetMountPoint(); Usage( argv[0] ); return( -1 ); } bFlag = GetVolumeNameForVolumeMountPoint( argv[2], // 输入挂载点或目录 Buf, // 输出卷名 BUFSIZE ); if (bFlag != TRUE) { printf( "Retrieving volume name for %s failed./n", argv[2] ); return (-2); } printf( "Volume name of %s is %s/n", argv[2], Buf ); bFlag = SetVolumeMountPoint( argv[1], // 挂载点 Buf // 需要挂载的卷 ); if (!bFlag) { printf ("Attempt to mount %s at %s failed. error code is/n", argv[2], argv[1], GetLastError()); } return (bFlag); }

4.2.3 判断光驱中是否有光盘

判断光驱中是否有光盘，仍然可以使用在4.2.1小节介绍的GetDriveType和GetVolumeInformation函数实现。首先使用驱动器根路径作为GetDriveType和参数，如果返回值是DRIVE_CDROM，则说明此驱动器为光驱。然后使用GetVolumeInformation获取信息，如果成功，则说明存光盘已经放入。调用完成后GetVolumeInformation函数的第7个参数LPTSTR lpFileSystemNameBuffer存储的是文件系统的类别字符串，光盘一般是CDFS。如果调用GetVolumeInformation时返回FALSE，并且GetLastError返回21，则说明驱动器中未放入光盘。

1．关键API
(1）GetDiskType与GetVolumeInformation。
这两个API已经在4.2.1小节介绍过，这里不再赘述。
（2）GetLastError。
获取在执行中本线程最近的一次错误。本函数是很多系统API返回执行错误原因的方法。可能使用SetLastError函数设置本线程的Last-Error值。GetLastError函数原型如下：

* 4.2.3	判断光驱中是否有光盘
 **************************************/
/* 头文件　*/
#include <windows.h>
#include <stdio.h>
#include <tchar.h>
/* 预定义　*/
#define BUFSIZE            512

/* ************************************
 * int main( int argc, PCHAR argv[] )
 * 功能	应用程序主函数，根据输入的驱动器
 *		根路径参数判断是否为光驱，是否放
 *		入光盘。
 * 参数	驱动器根路径，比如“D:/”。
 **************************************/

int main( int argc, PCHAR argv[] )
{
	//存储文件系统类别名
	CHAR szFileSystemNameBuffer[BUFSIZE];
	DWORD dwLastError;
	DWORD dwFileSystemFlags;

//判断是否输入运行时参数
	if( argc != 2 ) 
	{
		printf("请输入驱动器的根路径，比如： /"D:///"/n");
		return( -1 );
	}
	
	//判断输入的驱动器是否为CD/DVD ROM
	if(GetDriveType(argv[1])!=DRIVE_CDROM)
	{
		printf("驱动器 %s 不是 CD/DVD ROM。/n",argv[1]);
		return( -1 );
	}
	
	//获取卷信息
	if (!GetVolumeInformation(
		argv[1], NULL, 0,
		NULL,NULL,
		&dwFileSystemFlags,
		szFileSystemNameBuffer,
		BUFSIZE
		))
	{
		dwLastError = GetLastError();
		if(dwLastError == 21)
		{
			printf("设备未就绪,请放入光盘！/n");
			return 0;
		}
		else
		{
			printf("GetVolumeInformation 错误 %d/n",dwLastError);
			return 0;
		}
	}
	printf ("光盘已经放入，文件系统类别 %s。/n",szFileSystemNameBuffer);
	return 0;
}

4.2.4 获取磁盘分区的总容量、空闲容量、簇、扇区信息

获取磁盘分区的总容量和空闲空间的容量可以使用GetDiskFreeSpace函数或GetDiskFree SpaceEx函数。GetDiskFreeSpace使用DWORD类型作为输出参数，由于DWOR长度为32位，最大只能表示4GB，而一般的磁盘分区大小都大于4GB，所以，GetDiskFreeSpace并不直接返回磁盘的总容量和空闲空间的容量，而是使用总簇数、空闲的簇数、每簇的扇区数、每扇区的字节数来表示。用户在编程时，可以使用它们的乘积来获得最终结果。而GetDiskFreeSpaceEx使用ULARGE_INTEGER (DWORD64)类型的数据来存储磁盘空间总空间和剩余空间，所以可以直接获得结果。DWORD64可以表示约16777216TB的数据量(DWORD64最大可表示2Byte，lTB=2Byte，

(2）GetDiskFreeSpacEX。
获取驱动器根路径作为输入，获取用户可用的空闲空间的字节数、空闲空间的字节数、磁盘总容量的字节数，其函数原型如下：

2．关键数据结构
GetDiskFreeSpaceEx函数使用到了数据结构ULARGE_INTEGER，数据类型PULARGE
INTEGER是指向它的指针。ULARGE__ INTEGER的定义如下，此数据结构使用两个DWORD来表
示64位数据。低位存储于前，高位存储于后，与DWORD64的存储形式是一致的，所以可以直接强制类型转换为DOWRD64类型。也可以直接使用QuadPart成员，QuadPart成员是ULONGLONG形数据结构，在一般32位主机上，与DWORD64具有同样的长度。

/* ************************************ *《精通Windows API》 * 示例代码 * diskspace.c * 4.2.4 获取磁盘空间信息 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* ************************************ * BOOL GetDiskSpaceInfo(LPCSTR pszDrive * 功能根据输入的驱动器，获取磁盘总容量 * 空闲空间、簇数量等磁盘信息 * 参数驱动器根路径，比如“D:/”。 **************************************/ BOOL GetDiskSpaceInfo(LPCSTR pszDrive) { DWORD64 qwFreeBytesToCaller, qwTotalBytes, qwFreeBytes; DWORD dwSectPerClust, dwBytesPerSect, dwFreeClusters, dwTotalClusters; BOOL bResult; //使用GetDiskFreeSpaceEx获取磁盘信息并打印结果 bResult = GetDiskFreeSpaceEx (pszDrive, (PULARGE_INTEGER)&qwFreeBytesToCaller, (PULARGE_INTEGER)&qwTotalBytes, (PULARGE_INTEGER)&qwFreeBytes); if(bResult) { printf("使用GetDiskFreeSpaceEx获取磁盘空间信息/n"); printf("可获得的空闲空间（字节）: /t%I64d/n", qwFreeBytesToCaller); printf("空闲空间（字节）: /t/t%I64d/n", qwFreeBytes); printf("磁盘总容量（字节）: /t/t%I64d/n", qwTotalBytes); } //使用GetDiskFreeSpace获取磁盘信息并打印结果 bResult = GetDiskFreeSpace (pszDrive, &dwSectPerClust, &dwBytesPerSect, &dwFreeClusters, &dwTotalClusters); if(bResult) { printf("/n使用GetDiskFreeSpace获取磁盘空间信息/n"); printf("空闲的簇数量 : /t/t/t%d/n",dwFreeClusters); printf("总簇数量 : /t/t/t%d/n",dwTotalClusters); printf("每簇的扇区数量 : /t/t%d/n",dwSectPerClust); printf("每扇区的容量（字节）: /t/t%d/n",dwBytesPerSect); printf("空闲空间（字节）: /t/t%I64d/n", (DWORD64)dwFreeClusters* (DWORD64)dwSectPerClust*(DWORD64)dwBytesPerSect); printf("磁盘总容量（字节）: /t/t%I64d", (DWORD64)dwTotalClusters* (DWORD64)dwSectPerClust*(DWORD64)dwBytesPerSect); } return bResult; } /* ************************************ * int main( int argc, PCHAR argv[] ) * 功能应用程序主函数，根据输入参数 * 调用GetDiskSpaceInfo函数获取 * 磁盘空间信息 * 参数驱动器根路径，比如“D:/”。 **************************************/ int main(int argc, PCHAR argv[]) { GetDiskSpaceInfo (argv[1]); }

4.3 文件和目录管理

文件和目录管理是Windows系统编程最为基本的内容，几乎所有的应用程序都会使用到文件和目录的操作。本节将向读者演示如何创建目录、遍历目录、创建文件、打开文件、读写文件、移动复制删除文件等。本节通过以下多个实例来讲解Windows API对文件和目录的管理。
◇删除、复制、重命名、移动文件。
◇创建、打开、读写文件。
◇创建、打开目录。
◇获取当前目录、获取程序所在的目录、获取模块路径。
◇查找文件、遍历目录下的文件和子目录。
◇递归遍历目录树。

◇获取、设置文件属性和时间。

4.3.1 删除、复制、重命名、移动文件

Windows系统为文件的删除、复制、重命名或移动文件提供了相应的API函数。删除文件使用DeleteFile函数；复制文件使用CopyFile函数；重命名文件和移动文件实际是一个操作，使用MoveFile函数。这几个函数的使用都非常简单，下面分别介绍。
1．关键API
(1) DeleteFile。

DeleteFile的功能是删除文件。以文件路径作为输入，指向需要删除的文件。文件路径可以是类似于“c：/files/delete.txt”的绝对路径，也可以是类似于“./delete.txt”的相对路径，二相对于可执行文件所在的路径。

(2) CopyFile。
CopyFile的功能是复制文件。通过参数输入复制文件和源路径和目的路径，路径可以是绝对路径也可以是相对路径，还可以通过参数指明如果目的路径已经存在文件，是否覆盖。可以使用CopyFileEx函数进行更为高级的操作，比如在复制进行过程中取消复制等。CopyFileEx可以指定
一个回调函数来处理文件复制中所可能发生的各种情况。

3) MoveFile。
MoveFile的功能是移动、重命名文件和目录。通过参数输入源路径和目的路径，路径可以是绝对路径也可以是相对路径，如果目的路径的文件或目录已经存在，则返回失败。可以使用MoveFileEx函数来指定更多的选项，如果已经存在是否替换等。还可以使用MoveFileWithProgress指定一个回调函数来处理文件移动中所可能发生的各种情况。函数原型如下：

(4) CopyFileEx、MoveFileEx以及MoveFileWithProgreSS.
这3个API函数功能更丰富，但是限于篇幅这里不再做详细介绍，读者可以使用SDK文档学习它们的使用方法。

/* ************************************ *《精通Windows API》 * 示例代码 * wr.c * 4.3.2 创建、打开、读写文件，获取文件大小 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* ************************************ * DWORD ReadFileContent(LPSTR szFilePath) * 功能获取文件大小 * 读取文件内容，并以16进制的形式打印出来 * 参数 LPSTR szFilePath * 文件路径 **************************************/ DWORD ReadFileContent(LPSTR szFilePath) { //文件大小 HANDLE hFileRead; //保存文件大小 LARGE_INTEGER liFileSize; //成功读取的文件数据大小 DWORD dwReadedSize; //累加计算已经读取数据的大小 LONGLONG liTotalRead = 0; //文件数据缓存 BYTE lpFileDataBuffer[32]; //打开已经存在的文件，读取内容。 hFileRead = CreateFile(szFilePath,// 要打开的文件名 GENERIC_READ, // 以读方式打开 FILE_SHARE_READ, // 可共享读 NULL, // 默认安全设置 OPEN_EXISTING, // 只打开已经存在的文件 FILE_ATTRIBUTE_NORMAL, // 常规文件属性 NULL); // 无模板 //打开文件是否成功。 if(hFileRead==INVALID_HANDLE_VALUE) { printf("打开文件失败：%d",GetLastError()); } if(!GetFileSizeEx(hFileRead,&liFileSize)) { printf("获取文件大小失败：%d",GetLastError()); } else { printf("文件大小为：%d/n",liFileSize.QuadPart); } //循环读取并打印文件内容 while(TRUE) { DWORD i; if(!ReadFile(hFileRead, //读文件的句柄 lpFileDataBuffer, //存储读取的文件内容 32, //读的大小（字节） &dwReadedSize, //实际读取的大小 NULL)) //不使用Overlapped { printf("读文件错误：%d/n",GetLastError()); break; } printf("读取了%d字节，文件内容是：",dwReadedSize); for(i=0; i<dwReadedSize; i++) { printf("0x%x ",lpFileDataBuffer[i]); } printf("/n"); liTotalRead += dwReadedSize; if(liTotalRead == liFileSize.QuadPart) { printf("读文件结束/n"); break; } } CloseHandle(hFileRead); return 0; } /* ************************************ * SaveDataToFile * 功能将数据存储到文件末尾 * 参数 LPSTR szFilePath 文件路径 * LPVOID lpData 需存储的数据 * DWORD dwDataSize 数据大小（字节） **************************************/ DWORD SaveDataToFile( LPSTR szFilePath, LPVOID lpData, DWORD dwDataSize) { //文件句柄 HANDLE hFileWrite; //成功写入的数据大小 DWORD dwWritedDateSize; //打开已经存在的文件，读取内容。 hFileWrite = CreateFile(szFilePath, // 要打开的文件名 GENERIC_WRITE, // 以写方式打开 0, // 可共享读 NULL, // 默认安全设置 OPEN_ALWAYS, // 打开已经存在的文件，没用则创建 FILE_ATTRIBUTE_NORMAL, // 常规文件属性 NULL); // 无模板 //判断是否打开成功 if(hFileWrite==INVALID_HANDLE_VALUE) { printf("打开文件失败：%d/n",GetLastError()); } //设置文件指针到文件尾 SetFilePointer(hFileWrite,0,0,FILE_END); //将数据写入文件 if(!WriteFile(hFileWrite,lpData,dwDataSize,&dwWritedDateSize,NULL)) { printf("写文件失败：%d/n",GetLastError()); } else { printf("写文件成功，写入%d字节。/n",dwWritedDateSize); } CloseHandle(hFileWrite); return 0; } /* ************************************ * int main(void) * 功能演示使用SaveDataToFile和ReadFileContent函数 **************************************/ int main(void) { LPSTR szFileData = "这是一个例子"; SaveDataToFile("C://show.txt",szFileData,lstrlen(szFileData)); ReadFileContent("C://show.txt"); return 0; }

4.3.2 创建、打开、读写文件，获取文件大小

在Windows系统中，创建和打开文件都是使用API函数CreateFile，CreateFile通过指定不同的参数来表示是新建一个文件，打开已经存在的文件，还是重新建立文件等。读写文件最为直接的方式是使用ReadFile和WriteFile函数，也可以使用文件镜像，获取文件大小一般使用GetFileSize函数，也可以使用GetFileAttributesEx等函数（在4.3.7节介绍）。读写文件、获取文件大小之前都需要使用CreateFile创建或打开的文件，获得文件句柄。
在文件操作中，文件句柄是一个关键的概念。文件句柄惟一标识了一个文件，ReadFile、
WriteFile、GetFileSize等函数是使用文件句柄作为参数来表示，用户需要读、写、获取大小的文件是哪一个文件。在对文件进行操作前，都必须要使用CreateFile获得文件句柄。

1．关键API
（1）CreateFile
CreateFile是文件操作中最主要的一个函数。几乎所有的文件操作都需要使用到文件句柄。而CreateFile函数为这些操作建立文件句柄。CreateFile函数定义如下：

（2）ReadFile。

ReadFile动能是从文件中读出数据。需要使用CreateFile所返回的文件句柄。函数原型如下：

（3）WriteFile。
WriteFile函数的功能是将数据写入到文件中，写入到文件指针所在的位置，写入操作完成后，文件指针会移动到写入的数据之后，函数原型如下：

（4）GetFileSize、GetFileSizeEX.
GetFileSize、GetFileSizeEX的功能是一致的，都是获取文件大小，函数原型分别如下。

/* ************************************ 《精通Windows API》示例代码 * files.c * 4.3.1 删除、复制、重命名、移动文件 **************************************/ /* 头文件　/ #include <windows.h> #include <stdio.h> / ************************************ * int main( int argc, PCHAR argv[] ) * 功能应用程序主函数，根据输入参数 * 删除、复制、重命名文件 * * 参数删除文件： * -d 文件路径 * 将文件路径1的文件复制到文件路径2： * -c 文件路径1 文件路径2 * 将文件路径1的文件移动、重命名为文件路径2的文件 * -m 文件路径1 文件路径2 **************************************/ int main(int argc, PCHAR argv[]) { LPSTR y="c:/2.bat"; LPSTR x="c:/1.bat"; //-d参数，删除文件。 if(0==lstrcmp("-d",argv[1]) && argc==3) { if(!DeleteFile(argv[2])) { printf("删除文件错误：%x/n",GetLastError()); } else { printf("删除成功！/n"); } } //-c参数，复制文件。 //如果文件存在，询问用户是否覆盖 else if(0==lstrcmp("-c",argv[1]) && argc==4) { //复制，不覆盖已经存在的文件 if(!CopyFile(argv[2],argv[3],TRUE)) { //LastError == 0x50，文件存在。 if(GetLastError() == 0x50) { printf("文件%s已经存在，是否覆盖？y/n：",argv[3]); if('y'==getchar()) { //复制，覆盖已经存在的文件。 if(!CopyFile(argv[2],argv[3],FALSE)) { printf("复制文件错误，%d/n",GetLastError()); } else { printf("复制成功！/n"); } } else { return 0; } } } else { printf("复制成功！/n"); } } //-m参数，移动、重命名文件。 else if(0==lstrcmp("-m",argv[1]) && argc==4) { if(!MoveFile( x,y)) { printf("移动文件错误：%d/n",GetLastError()); } else { printf("移动文件成功！/n"); } } else { printf("参数错误！/n"); } }

4.3.3 创建目录

编程实现创建目录是非常简单的，只要使用API函数CreateDirectory即可。
1．关键API
（1） Createdirectory
函数原型如下：
◇参数
lpPathName:输入参数，所要创建的目录名或路径。
lpSecurityAttributes:输入参数，设置为NULL。
◇返回值
返回BOOL值，表示是否成功。
◇使用说明
如果程序返回失败，可以使用GetLastError函数获取错误信息。可能的值包括ERROR
ALREADY EXISTS（文件夹已经存在）和ERROR PATH NOT FOUND（路径不存在）。

/* ************************************ *《精通Windows API》 * 示例代码 * dir.c * 4.3.3 创建目录 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* ************************************ * int main(void) * 功能演示使用CreateDirectory创建目录 **************************************/ int main(void) { //在程序的当前目录下创建“sub_dir”子目录 LPSTR szDirPath = "sub_dir"; if (!CreateDirectory(szDirPath, NULL)) { printf("创建目录 %s 错误。/n",szDirPath); return 1; } //在C盘下创建目录“example_dir” szDirPath = "C://example_dir"; if (!CreateDirectory(szDirPath, NULL)) { printf("创建目录 %s 错误。/n",szDirPath); return 1; } printf("成功/n"); return 0; }

4.3.4 获取程序所在的目录、程序模块路径，获取和设置当前目录

Windows系统提供一组API实现对程序运行时相关目录的获取和设置。用户可以使用
GetCurrentDirectory和SetCurrentDirectory获取程序的当前目录，获取模块的路径使用
GetModuleFileName，如果以NULL参数调用GetModuleFileName，将会返回当前模块的路径。如果在程序主模块(exe)中获取当前模块路径，便可以从当前模块的路径中提取出程序运行时所在的路径。
1．关键API
（1）GetCurrentDirectory。
获取进程的当前目录，函数原型如下：

（2）SetCurrentDirectory。
设置进程的当前目录，函数原型如下：

(3)GetModuleFileName。
获取模块文件名，当第一个参数为NULL时获取当前模块路径，函数原型如下：

/* ************************************ *《精通Windows API》 * 示例代码 * cur_mod_dir.c * 4.3.4 获取当前目录、获取程序所在的目录、获取模块路径 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* ************************************ * int main(void) * 功能演示使用设置获取当前路径 * 演示获取模块路径 **************************************/ int main(void) { //用于存储当前路径 CHAR szCurrentDirectory[MAX_PATH]; //用于存储模块路径 CHAR szMoudlePath[MAX_PATH]; //Kernel32文件名与句柄 LPSTR szKernel32 = "kernel32.dll"; HMODULE hKernel32; //当前路径的长度，也用于判断获取是否成功 DWORD dwCurDirPathLen; //获取进程当前目录 dwCurDirPathLen = GetCurrentDirectory(MAX_PATH,szCurrentDirectory); if(dwCurDirPathLen == 0) { printf("获取当前目录错误。/n"); return 0; } printf("进程当前目录为 %s /n",szCurrentDirectory); //将进程当前目录设置为“C:/” lstrcpy(szCurrentDirectory, "C://"); if(!SetCurrentDirectory(szCurrentDirectory)) { printf("设置当前目录错误。/n"); return 0; } printf("已经设置当前目录为 %s /n",szCurrentDirectory); //在当前目录下创建子目录“current_dir” //运行完成后C:盘下将出现文件夹“current_dir” CreateDirectory("current_dir", NULL); //再次获取系统当前目录 dwCurDirPathLen = GetCurrentDirectory(MAX_PATH,szCurrentDirectory); if(dwCurDirPathLen == 0) { printf("获取当前目录错误。/n"); return 0; } printf("GetCurrentDirectory获取当前目录为 %s /n", szCurrentDirectory); //使用NULL参数，获取本模块的路径。 if(!GetModuleFileName(NULL,szMoudlePath,MAX_PATH)) { printf("获取模块路径录错误。/n"); return 0; } printf("本模块路径 %s /n",szMoudlePath); //获取Kernel32.dll的模块句柄。 hKernel32 = LoadLibrary(szKernel32); //使用Kernel32.dll的模块句柄，获取其路径。 if(!GetModuleFileName(hKernel32,szMoudlePath,MAX_PATH)) { printf("获取模块路径错误。/n"); return 0; } printf("kernel32模块路径 %s /n",szMoudlePath); return 0; }

4.3.5 查找文件、遍历指定目录下的文件和子目录

Windows API中，有一组专门的函数和结构，用于遍历目录，它们是FindFirstFile函数、
FindNextFile函数和WIN32_FIND_DATA结构。使用FindFirstFile和FindNextFile函数并与do-while循环结合，可以完成遍历目录的任务，详见实例4-10。
值得一提的是，FindFirstFile输入参数的路径需使用通配符，也就是用户可以根据一些条件来对查找的文件作简单的过滤。实例4-10讲解查找特定目录下的所有文件和文件夹。读者可根据自己的需要，指定查找文件的条件。
1．关键API
（1）FindFirstFile。
查找第一个目录或文件，获取查找句柄，函数原型如下：

（2）FindNextFile
对文件、文件夹进行循环查找，函数原型如下：

2．关键结构
WIN32_FIND_DATA结构用于表示找到的文件，结构中包括文件、目录的名字，创建、最后访问和最后写入时间，文件大小、文件属性等。

/* ************************************ *《精通Windows API》 * 示例代码 * sub_dir.c * 4.3.5 遍历目录下的文件和子目录 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* ************************************ * DWORD EnumerateFileInDrectory(LPSTR szPath) * 功能遍历目录下的文件和子目录，将显示文件的 * 文件和文件夹隐藏、加密的属性 * 参数 LPTSTR szPath，为需遍历的路径 * 返回值 0代表执行完成，1代码发生错误 **************************************/ DWORD EnumerateFileInDrectory(LPSTR szPath) { WIN32_FIND_DATA FindFileData; HANDLE hListFile; CHAR szFilePath[MAX_PATH]; //构造代表子目录和文件夹路径的字符串，使用通配符“*” lstrcpy(szFilePath, szPath); //注释的代码可以用于查找所有以“.txt结尾”的文件。 //lstrcat(szFilePath, "//*.txt"); lstrcat(szFilePath, "//*"); //查找第一个文件/目录，获得查找句柄 hListFile = FindFirstFile(szFilePath,&FindFileData); //判断句柄 if(hListFile==INVALID_HANDLE_VALUE) { printf("错误：%d",GetLastError()); return 1; } else { do { /* 如果不想显示代表本级目录和上级目录的“.”和“..”，可以使用注释部分的代码过滤。 if(lstrcmp(FindFileData.cFileName,TEXT("."))==0|| lstrcmp(FindFileData.cFileName,TEXT(".."))==0) { continue; } */ //打印文件名、目录名 printf("%s/t/t",FindFileData.cFileName); //判断文件属性，加密文件或文件夹 if(FindFileData.dwFileAttributes&FILE_ATTRIBUTE_ENCRYPTED) { printf("<加密> "); } //判断文件属性，隐藏文件或文件夹 if(FindFileData.dwFileAttributes&FILE_ATTRIBUTE_HIDDEN) { printf("<隐藏> "); } //判断文件属性，目录 if(FindFileData.dwFileAttributes&FILE_ATTRIBUTE_DIRECTORY) { printf("<DIR> "); } //读者可根据文件属性表中的内容自行添加判断文件属性。 printf("/n"); } while(FindNextFile(hListFile, &FindFileData)); } return 0; } /* ************************************ * int main(int argc, PCHAR argv[]) * 功能调用ListFileInDrectory * 遍历目录下的文件和子目录 * 参数 argv[1]为需遍历的路径，如果为空则获取 * 当前路径 **************************************/ int main(int argc, PCHAR argv[]) { if(argc == 2) { EnumerateFileInDrectory(argv[1]); } else { CHAR szCurrentPath[MAX_PATH]; GetCurrentDirectory(MAX_PATH,szCurrentPath); EnumerateFileInDrectory(szCurrentPath); } return 0; }

4.3.6 递归遍历目录树

在实例4-10的基础上稍加改造，进行循环递归调用，采用树形结构深度遍历的方法。可以遍历指定目录中的所有文件、包括子目录中的文件。代码实现如实例4-11所示。

/* ************************************ *《精通Windows API》 * 示例代码 * tree.c * 4.3.6 递归遍历目录树 * 2007年10月 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* 预处理申明 */ #pragma comment (lib, "User32.lib") /* 函数申明　*/ DWORD ListAllFileInDrectory(LPSTR szPath); /* 全局变量　*/ //记录所有的文件和目录数 DWORD dwTotalFileNum = 0; /* ************************************ * DWORD ListAllFileInDrectory(LPSTR szPath) * 功能遍历目录及所有子目录，打印路径 * * 参数 LPTSTR szPath，为需遍历的目录 * * 返回值 0代表执行完成，1代码发生错误 **************************************/ DWORD ListAllFileInDrectory(LPSTR szPath) { CHAR szFilePath[MAX_PATH]; WIN32_FIND_DATA FindFileData; HANDLE hListFile; CHAR szFullPath[MAX_PATH]; //构造代表子目录和文件夹路径的字符串，使用通配符“*” lstrcpy(szFilePath, szPath); lstrcat(szFilePath, "//*"); //查找第一个文件/目录，获得查找句柄 hListFile = FindFirstFile(szFilePath,&FindFileData); if(hListFile==INVALID_HANDLE_VALUE) { printf("错误：%d",GetLastError()); return 1; } else { do { // 过滤“.”和“..”，不需要遍历 if(lstrcmp(FindFileData.cFileName,TEXT("."))==0|| lstrcmp(FindFileData.cFileName,TEXT(".."))==0) { continue; } //构造成全路径 wsprintf(szFullPath,"%s//%s", szPath,FindFileData.cFileName); dwTotalFileNum++; //打印 printf("/n%d/t%s/t",dwTotalFileNum,szFullPath); //如果是目录，则递归调用，列举下级目录 if(FindFileData.dwFileAttributes&FILE_ATTRIBUTE_DIRECTORY) { printf("<DIR>"); ListAllFileInDrectory(szFullPath); } } while(FindNextFile(hListFile, &FindFileData)); } return 0; } /* ************************************ * int main(int argc, PCHAR argv[]) * 功能调用ListAllFileInDrectory * 遍历目录下的文件和子目录 * * 参数 argv[1]为需遍历的路径，如果为空则获取 * 当前路径 * * 2007年10月 * **************************************/ int main(int argc, PCHAR argv[]) { if(argc == 2) { ListAllFileInDrectory(argv[1]); } else { CHAR szCurrentPath[MAX_PATH]; GetCurrentDirectory(MAX_PATH,szCurrentPath); ListAllFileInDrectory(szCurrentPath); } return 0; }

4.3.7 获取、设置文件属性和时间

为了获取文件属性，用户可以使用GetFileAttributes与GetFileAttributesEx函数。
GetFileAttributesEx函数除了返回文件属性外，还返回文件时间信息、文件大小等。
GetFileAttributesEx将返回结果保存在WIN32_FILE_ATTRIBUTE DATA结构中。
获取的文件时间是以FILETIME格式存在的，如果要正确显示，还需要对其时区进行调整，调整为本地时区，然后转换为系统时间格式，便于显示。
前面在获取文件大小时已经介绍，NTFS文件系统使用了64位数据来表示文件大小。因为32位的数据最多只能表示4GB的大小。Windows将其分为了高32位和低32位，两个都需要使用到，这一点尤其要在对大于4GB的文件操作时注意。
1．关键API
(1)GetFileAttributeS。
获取文件或目录的属牲-函数原型如下：

（2）GetFileAttributesEx。
获取文件或目录的属性、时间、大小，以WIN32_FILE ATTRIBUTE_DATA结构的形式返回
结果，函数原型如下：

(3) SetFileAttributes.
设置文件或目录的属性，函数原型如下：

（4）FileTimeToLocalFileTime。
把文件时间转换为本地的文件时间，函数原型如下：

5）FileTimeToSystemTime
将文件时间转换为系统时间（SYSTEMTIME格式），便于显示，函数原型如下：

2．关键数据结构
(1) FILETIM。
此结构用最小的数据量表示的时间，但是不便于用户查看和显示。通过API获取的系统时间都是这种格式的。如果要使用显示，可以使用FileTimeToSystemTime转换为便于显示的SYSTEMTIME结构。

(2) SYSTEMTIME。
此结构使用了较为直观的方式表示时间。

(3) WIN32_FILE ATTRIBUTE_DATA。
GetFileAttributesEx使用这个结构表示返回结果，包括文件属性、文件创建时间、文件最后访问时间、文件最后写入时间和文件大小。

/* ************************************ *《精通Windows API》 * 示例代码 * attr.c * 4.3.7 获取、设置文件属性和时间 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* 函数申明　*/ DWORD ShowFileTime(PFILETIME lptime); DWORD ShowFileSize(DWORD dwFileSizeHigh,DWORD dwFileSizeLow); DWORD ShowFileAttrInfo(DWORD dwAttribute); DWORD SetFileHiddenAndReadonly(LPSTR szFileName); /* ************************************ * DWORD ShowFileAttributes(LPSTR szPath) * 功能获取并显示文件属性， * 调用ShowFileTime、ShowFileSize和 * ShowFileAttrInfo函数 * * 参数 LPTSTR szPath，获取并显示此文件的属性 * * 返回值 0代表执行完成，1代码发生错误 **************************************/ DWORD ShowFileAttributes(LPSTR szPath) { //文件属性结构 WIN32_FILE_ATTRIBUTE_DATA wfad; printf("文件：%s/n",szPath); //获取文件属性 if(!GetFileAttributesEx(szPath, GetFileExInfoStandard, &wfad)) { printf("获取文件属性错误：%d/n",GetLastError()); return 1; } //显示相关时间 printf("创建时间：/t"); ShowFileTime(&(wfad.ftCreationTime)); printf("最后访问时间：/t"); ShowFileTime(&(wfad.ftLastAccessTime)); printf("最后修改时间：/t"); ShowFileTime(&(wfad.ftLastWriteTime)); //显示文件大小 ShowFileSize(wfad.nFileSizeHigh,wfad.nFileSizeLow); //显示文件属性 ShowFileAttrInfo(wfad.dwFileAttributes); return 0; } /* ************************************ * DWORD ShowFileAttrInfo(DWORD dwAttribute) * 功能打印将文件属性 * * 参数 DWORD dwAttribute，文件属性 * * 返回值 0 **************************************/ DWORD ShowFileAttrInfo(DWORD dwAttribute) { //依次判断属性，并显示。 printf("文件属性：/t"); if(dwAttribute&FILE_ATTRIBUTE_ARCHIVE) printf("<ARCHIVE> "); if(dwAttribute&FILE_ATTRIBUTE_COMPRESSED) printf("<压缩> "); if(dwAttribute&FILE_ATTRIBUTE_DIRECTORY) printf("<目录> "); if(dwAttribute&FILE_ATTRIBUTE_ENCRYPTED) printf("<加密> "); if(dwAttribute&FILE_ATTRIBUTE_HIDDEN) printf("<隐藏> "); if(dwAttribute&FILE_ATTRIBUTE_NORMAL) printf("<NORMAL> "); if(dwAttribute&FILE_ATTRIBUTE_OFFLINE) printf("<OFFLINE> "); if(dwAttribute&FILE_ATTRIBUTE_READONLY) printf("<只读> "); if(dwAttribute&FILE_ATTRIBUTE_SPARSE_FILE) printf("<SPARSE> "); if(dwAttribute&FILE_ATTRIBUTE_SYSTEM) printf("<系统文件> "); if(dwAttribute&FILE_ATTRIBUTE_TEMPORARY) printf("<临时文件> "); printf("/n"); return 0; } /* ************************************ * DWORD ShowFileSize(DWORD dwFileSizeHigh, DWORD dwFileSizeLow) * 功能打印文件大小信息 * * 参数 DWORD dwFileSizeHigh，文件大小高32位 * DWORD dwFileSizeLow，文件大小低32位 * * 返回值 0 **************************************/ DWORD ShowFileSize(DWORD dwFileSizeHigh, DWORD dwFileSizeLow) { ULONGLONG liFileSize; liFileSize = dwFileSizeHigh; //高们移动32位 liFileSize <<= sizeof(DWORD)*8; liFileSize += dwFileSizeLow; printf("文件大小：/t%I64u 字节/n",liFileSize); return 0; } /* ************************************ *DWORD ShowFileTime(PFILETIME lptime) * 功能轮换文件时间，将打印 * * 参数 PFILETIME lptime，指向文件时间的指针 * * 返回值 0 **************************************/ DWORD ShowFileTime(PFILETIME lptime) { //文件时间结构 FILETIME ftLocal; //系统时间结构 SYSTEMTIME st; //调整为系统所在时区的时间 FileTimeToLocalFileTime( lptime, &ftLocal ); //将文件时间转换为SYSTEMTIME格式，便于显示。 FileTimeToSystemTime( &ftLocal, &st ); //显示时间信息字符串 printf("%4d年%.2d月%#02d日，%.2d:%.2d:%.2d/n", st.wYear,st.wMonth,st.wDay,st.wHour,st.wMinute,st.wSecond); return 0; } /* ************************************ * DWORD SetFileHiddenAndReadonly(LPSTR szFileName) * 功能将指定的文件设置为隐藏和只读 * * 参数 LPSTR szFileName，文件路径 * * 返回值 0 **************************************/ DWORD SetFileHiddenAndReadonly(LPSTR szFileName) { //获取原来的文件属性 DWORD dwFileAttributes = GetFileAttributes(szFileName); //将只读和隐藏属性附加到原来的文件属性上 dwFileAttributes |= FILE_ATTRIBUTE_READONLY; dwFileAttributes |= FILE_ATTRIBUTE_HIDDEN; //设置文件属性，并判断是否成功。 if(SetFileAttributes(szFileName, dwFileAttributes)) { printf("文件%s的隐藏和属性设置成功/n",szFileName); } else { printf("属性设置; %d/n",GetLastError()); } return 0; } /* ************************************ * int main(int argc, PCHAR argv[]) * 功能设置和获取文件属性等 * * 参数显示第一个参数指定文件的属性、时间、大小 * 将第二个参数的属性设置为隐藏、只读。 * * 返回值 0代表执行完成，1代码发生错误 **************************************/ int main(int argc, PCHAR argv[]) { if(argc != 3) { printf("请输入参数/n"); printf("显示第一个参数指定文件的属性、时间、大小；/n"); printf("将第二个参数的属性设置为隐藏、只读。"); return 1; } ShowFileAttributes(argv[1]); SetFileHiddenAndReadonly(argv[2]); return 0; }

4.4 内存映射文件

本节介绍Mapping File、文件句柄等较高级操作。本节将通过以下几个实例来讲解高级文件系统操作的API。
◇ 使用Mapping File提高文件读写的效率。
◇通过Mapping File在进程间共享内存。
◇通过文件句柄获得文件路径。
4.4.1 使用Mapping File提高文件读写的效率
文件映射( mapping)是一种在将文件内容映射到进程的虚拟地址空间的技术。视图(View)是一段虚拟地址空间，进程可以通过View来存取文件的内容，视图是一段内存，可以使用指针来操作视图。使用的文件映射之后，读写文件就如同对读写内存一样简单。在使用文件映射时需要创建映射对象，映射对象分为命名的和未命名的。映射对象还存取权限。
使用文件映射至少有3个好处，一是因为文件是存储于硬盘上的，而文件视图是一段内存，使用文件映射操作时更方便；二是效率更高；三是可以在不同的进程间共享数据。
文件映射依赖于系统虚拟内存管理的分页机制。
本节将演示如何使用文件映射，下一节将演示如何使用文件映射来进行内存共享。
1．关键API
（1）GetSystemInfo
获取系统信息，在实例 4-14中用于获取系统内存分配粒度。有关内存分配粒度的概念参见第5章和虚拟内存管理相关章节。
（2）CreateFileMapping。
创建mapping对象，函数原型如下

（3）MapViewOfFile。
创建视图，将文件mapping映射到当前进程内存虚拟地址空间。函数原型如下：

（4）FlushViewOfFile。
将视图中的文件数据写入到磁盘上。调用此参数后，对映射视图的内存操作将会及时反映到硬件中的文件。函数原型如下：

◇使用说明
如果不调用此函数，数据最终也会写回到硬盘，调用此函数后，数据会立刻写回到硬盘。
(5) FillMemory、CopyMemory。内存操作函数，分别为填充内存和复制内存，详见第5章

/* ************************************ *《精通Windows API》 * 示例代码 * file_map.c * 4.4.1 使用Mapping File提高文件读写的效率 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> /* 预处理申明　*/ #define BUFFSIZE 1024 // 内存大小 #define FILE_MAP_START 0x28804 // 文件映射的起始的位置 /* 全局变量　*/ LPTSTR lpcTheFile = TEXT("test.dat"); // 文件名 /* ************************************ * int main(void) * 功能演示使用文件mapping * * 参数无 * * 返回值 0代表执行完成，1代表发生错误 **************************************/ int main(void) { HANDLE hMapFile; // 文件内存映射区域的句柄 HANDLE hFile; // 文件的句柄 DWORD dBytesWritten; // 写入的字节数 DWORD dwFileSize; // 文件大小 DWORD dwFileMapSize; // 文件映射的大小 DWORD dwMapViewSize; // 视图（View）的大小 DWORD dwFileMapStart; // 文件映射视图的起始位置 DWORD dwSysGran; // 系统内存分配的粒度 SYSTEM_INFO SysInfo; // 系统信息 LPVOID lpMapAddress; // 内在映射区域的起始位置 PCHAR pData; // 数据 INT i; // 循环变量 INT iData; INT iViewDelta; BYTE cMapBuffer[32]; // 存储从mapping中计出的数据 // 创建一个文件 hFile = CreateFile(lpcTheFile, GENERIC_READ | GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL); //判断文件是否创建成功 if (hFile == INVALID_HANDLE_VALUE) { printf("CreateFile error/n",GetLastError); return 1; } // 依次写入整数，一共写入65535个整数 // 在32位平台下，大小为65535*32 for (i=0; i<65535; i++) { WriteFile (hFile, &i, sizeof (i), &dBytesWritten, NULL); } // 查看写入完成后的文件大小 dwFileSize = GetFileSize(hFile, NULL); printf("文件大小: %d/n", dwFileSize); //获取系统信息，内存分配粒度 //获取分配粒度，进行下面的几个计算， //目的是为了映射的数据与系统内存分配粒度对齐，提高内存访问效率 GetSystemInfo(&SysInfo); dwSysGran = SysInfo.dwAllocationGranularity; //计算mapping的起始位置 dwFileMapStart = (FILE_MAP_START / dwSysGran) * dwSysGran; // 计算mapping view的大小 dwMapViewSize = (FILE_MAP_START % dwSysGran) + BUFFSIZE; // 计算mapping的大小 dwFileMapSize = FILE_MAP_START + BUFFSIZE; // 计算需要读取的数据的偏移 iViewDelta = FILE_MAP_START - dwFileMapStart; // 创建File mapping hMapFile = CreateFileMapping( hFile, // 需要映射的文件的句柄 NULL, // 安全选项：默认 PAGE_READWRITE, // 可读，可写 0, // mapping对象的大小，高位 dwFileMapSize, // mapping对象的大小，低位 NULL); // mapping对象的名字 if (hMapFile == NULL) { printf("CreateFileMapping error: %d/n", GetLastError() ); return 1; } // 映射view lpMapAddress = MapViewOfFile(hMapFile, // mapping对象的句柄 FILE_MAP_ALL_ACCESS, // 可读，可写 0, // 映射的文件偏移，高32位 dwFileMapStart, // 映射的文件偏移，低32位 dwMapViewSize); // 映射到View的数据大小 if (lpMapAddress == NULL) { printf("MapViewOfFile error: %d/n", GetLastError()); return 1; } printf ("文件map view相对于文件的起始位置： 0x%x/n", dwFileMapStart); printf ("文件map view的大小：0x%x/n", dwMapViewSize); printf ("文件mapping对象的大小：0x%x/n", dwFileMapSize); printf ("从相对于map view 0x%x 字节的位置读取数据，", iViewDelta); // 将指向数据的指针偏移，到达我们关心的地方 pData = (PCHAR) lpMapAddress + iViewDelta; // 读取数据，赋值给变量 iData = *(PINT)pData; // 显示读取的数据 printf ("为：0x%.8x/n", iData); // 从mapping中复制数据，32个字节，并打印 CopyMemory(cMapBuffer,lpMapAddress,32); printf("lpMapAddress起始的32字节是："); for(i=0; i<32; i++) { printf("0x%.2x ",cMapBuffer[i]); } // 将mapping的前32个字节用0xff填充 FillMemory(lpMapAddress,32,(BYTE)0xff); // 将映射的数据写回到硬盘上 FlushViewOfFile(lpMapAddress,dwMapViewSize); printf("/n已经将lpMapAddress开始的32字节使用0xff填充。/n"); // 关闭mapping对象 if(!CloseHandle(hMapFile)) { printf("/nclosing the mapping object error %d!", GetLastError()); } //关闭文件 if(!CloseHandle(hFile)) { printf("/nError %ld occurred closing the file!", GetLastError()); } return 0; }

4.4.2 通过Mapping File在进程间传递和共享数据
进程间通信、共享数据有很多种方法，文件映射是常用的一种方法。因为mapping对象
系统中是全局的，一个进程创建的Mapping对象可以从另外一个进程中打开，映射视图就
进程间共享的内存了。一般在共享的内存数据量比较大时，选择使用文件映射进行共享。
1．关键API
（1）OpenFileMapping。
打开已经存在的文件映射，函数原型如下：

(2) UnmapViewO伍ile。
取消文件映射，函数原型如下：

/* ************************************ *《精通Windows API》 * 示例代码 * pro_s1.c * 4.4.2 通过Mapping File在进程间共享内存 **************************************/ /* 头文件　*/ #include <windows.h> #include <stdio.h> #include <conio.h> /* 预处理申明　*/ #define BUF_SIZE 256 /* 全局变量　*/ LPTSTR szName = TEXT("SharedFileMappingObject"); LPTSTR szMsg = TEXT("进程的消息"); /* ************************************ * int main(void) * 功能演示文件mapping共享内存，写入数据到共享内存 * * 参数无 * * 返回值 0代表执行完成，代表发生错误 **************************************/ void main(int argc, PCHAR argv[]) { //文件映射句柄 HANDLE hMapFile; //共享数据缓冲区指针 LPTSTR pBuf; //创建命名的文件映射，不代表任务硬盘上的文件 hMapFile = CreateFileMapping( INVALID_HANDLE_VALUE, NULL, PAGE_READWRITE, 0, BUF_SIZE, szName); if (hMapFile == NULL || hMapFile == INVALID_HANDLE_VALUE) { printf("CreateFileMapping error: %d/n", GetLastError()); return; } //创建View pBuf = (LPTSTR) MapViewOfFile(hMapFile, FILE_MAP_ALL_ACCESS, 0, 0, BUF_SIZE); if (pBuf == NULL) { printf("MapViewOfFile error %d/n", GetLastError()); return; } //将共享数据复制到文件映射中，如果运行时输入了参数则使用参数 if(argc==1) { CopyMemory((PVOID)pBuf, szMsg, strlen(szMsg)); } else { DWORD dwCopyLen = (lstrlen(argv[1])<BUF_SIZE) ? lstrlen(argv[1]): BUF_SIZE; CopyMemory((PVOID)pBuf, argv[1], dwCopyLen); } printf("运行程序，完成运行后，按任意键退出。"); _getch(); //取消映射，退出 UnmapViewOfFile(pBuf); CloseHandle(hMapFile); }

．实例4-15读取并显示共享数据
本实例代码从实例4-14共享的Mapping对象中读取数据，并将数据显示出来。实例4-14与实例4-15是两个进程，实现了进程间数据的共享。这两个进程可以通过各自的指针，对同一段内存进行读写。
本实例先打开指定对象名的Mapping对象（与实例4-14中使用的CreateFileMapping创建的Mapping对象需有一样的对象名），然后创建视图，从视图中读取数据。

/* ************************************ *《精通Windows API》 * 示例代码 * pro_s2.c * 4.4.2 通过Mapping File在进程间共享内存 **************************************/ #include <windows.h> #include <stdio.h> #include <conio.h> /* 预处理申明*/ #pragma comment (lib, "User32.lib") #define BUF_SIZE 256 /* 全局变量　*/ TCHAR szName[]=TEXT("SharedFileMappingObject"); /* ************************************ * int main(void) * 功能演示文件mapping共享内存，从共享数据中读信息 * * 参数无 * * 返回值 0代表执行完成，代表发生错误 **************************************/ void main() { HANDLE hMapFile; LPTSTR pBuf; //打开文件mapping hMapFile = OpenFileMapping( FILE_MAP_ALL_ACCESS, FALSE, szName); if (hMapFile == NULL) { printf("OpenFileMapping error: %d./n", GetLastError()); return; } //映射 pBuf = MapViewOfFile(hMapFile, FILE_MAP_ALL_ACCESS, 0, 0, BUF_SIZE); if (pBuf == NULL) { printf("MapViewOfFile error %d/n", GetLastError()); return; } //消息得到的共享数据 MessageBox(NULL, pBuf, TEXT("Process2"), MB_OK); //取消mapping，关闭句柄，返回 UnmapViewOfFile(pBuf); CloseHandle(hMapFile); }

4.4.3 通过文件句柄获得文件路径
Windows系统提供了一个名为GetMappedFileName的API函数，这个函数可以实现从
mapping对象的句柄得到被映射文件的路径。但是路径是以设备名的形式给出的，如类似于
“/Device/HarddiskVolume3/1.TXT”的形式。
将设备名转换为路径名需要使用到一个API函数-QueryDosDevice，这个函数可以将驱动器的根路径转换为设备名，然后进行循环比较，可得文件路径。
1．关键API
(1)GetMappedFileName。
从映射对象获取被映射文件的文件设备名，函数原型如下：

(2)QueryDosDevice
获取MS_DOS设备名，函数原型如下：

◇返回值返回DWORD值，如果成功，则返回值为lpTargetPath指向字符串的长度，如果失败为0。
2．实例4-16通过文件句柄获取文件路径
GetFileNameFromHandle通过参数输入的句柄创建mapping对象，然后调用GetMapped
FileName函数，获得对象所映射的文件的设备名，然后使用QueryDosDevice函数循环判断
驱动器设备名与路径的关系，在找到正确的驱动器路径后，构造好文件路径并输出。

/* ************************************ *《精通Windows API》 * 示例代码 * handle_path.cpp * 4.4.3 通过文件句柄获取文件路径 **************************************/ /* 头文件*/ #include <windows.h> #include <stdio.h> #include <tchar.h> #include <string.h> #include <psapi.h> /* 预处理申明*/ #pragma comment (lib, "Psapi.lib") #define BUFSIZE 512 /* 函数申明*/ BOOL GetFileNameFromHandle(HANDLE hFile) ; /* ************************************ * BOOL GetFileNameFromHandle(HANDLE hFile) * 功能从文件句柄获取文件路径 * * 参数 ANDLE hFile，需要获得路径的文件句柄 * * 返回值BOOL 是否成功。 **************************************/ BOOL GetFileNameFromHandle(HANDLE hFile) { TCHAR pszFilename[MAX_PATH+1]; HANDLE hFileMap; PVOID pMem; // 获得文件大小,并决断是否为 DWORD dwFileSizeHigh = 0; DWORD dwFileSizeLow = GetFileSize(hFile, &dwFileSizeHigh); if( dwFileSizeLow == 0 && dwFileSizeHigh == 0 ) { printf("不能map文件大小为的文件./n"); return FALSE; } // 创建mapping对象 hFileMap = CreateFileMapping(hFile, NULL, PAGE_READONLY, 0, 1, NULL); if (!hFileMap) { printf("CreateFileMapping error: %d",GetLastError()); return FALSE; } pMem = MapViewOfFile(hFileMap, FILE_MAP_READ, 0, 0, 1); if (!pMem) { printf("MapViewOfFile error: %d",GetLastError()); return FALSE; } // 从mapping对象获得文件名 if (0 == GetMappedFileName (GetCurrentProcess(), pMem, pszFilename, MAX_PATH)) { printf("GetMappedFileName error: %d",GetLastError()); return FALSE; } // 将设备名转换为路径 TCHAR szTemp[BUFSIZE] = {0}; if (0 == GetLogicalDriveStrings(BUFSIZE-1, szTemp)) { printf("GetLogicalDriveStrings error: %d",GetLastError()); return FALSE; } TCHAR szName[MAX_PATH]; TCHAR szDrive[3] = {0}; BOOL bFound = FALSE; PTCHAR p = szTemp; do { CopyMemory(szDrive,p,2*sizeof(TCHAR)); // 通过路径查找设备名 if (!QueryDosDevice(szDrive, szName, BUFSIZE)) { printf("QueryDosDevice error: %d",GetLastError()); return FALSE; } UINT uNameLen = lstrlen(szName); if (uNameLen < MAX_PATH) { //比较驱动器的设备名与文件设备名是否匹配 bFound = strncmp(pszFilename, szName,uNameLen) == 0; if (bFound) { //如果匹配，说明已经找到，构造路径。 TCHAR szTempFile[MAX_PATH]; wsprintf(szTempFile, TEXT("%s%s"), szDrive, pszFilename+uNameLen); lstrcpy(pszFilename, szTempFile); } } // 循环到下一个NULL while (*p++); } while (!bFound && *p); UnmapViewOfFile(pMem); CloseHandle(hFileMap); printf("File path is %s/n", pszFilename); return TRUE; } /* ************************************ * int main() * 功能查找第一个目录中第一个txt文件 * 打开文件，并根据文件句柄获得文件路径。 * * 参数未使用 * * 返回值0表示成功，表示失败。 **************************************/ int main() { HANDLE hFile; HANDLE hFind; WIN32_FIND_DATA wfd; hFind = FindFirstFile("*.txt",&wfd); if(hFind == INVALID_HANDLE_VALUE) { printf("can not find a file"); return 1; } //CloseHandle(hFind); printf("find %s at current dir/n",wfd.cFileName); hFile = CreateFile(wfd.cFileName, GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL); if(hFile == INVALID_HANDLE_VALUE) { printf("create file error, %d",GetLastError()); } else { GetFileNameFromHandle(hFile) ; } CloseHandle(hFile); return 0; }