windows磁盘相关API实践说明

原帖地址：http://www.cnblogs.com/matrix-r/p/3288886.html

API的列表如下，网上找的，我觉得还是蛮详细的：

磁盘和驱动器管理API
GetLogicalDrivers      获取主机中所有的逻辑驱动器,以BitMap的形式返回.
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设备名

GetLocalDrivers

       最近真的是发现做文档也是一种习惯啊。慢慢来吧。

       第一个函数GetLocalDrivers这个函数的返回值是一个DWORD，也就是以Bitmap形式返回相关的信息，从0位开始为A盘，从以往后递归就是BCD……

       这个函数无参数，函数原型如下：

DWORDGetLogicalDrives(VOID);

代码运行结果：

 

可以对应一下，确实是正确的。不过H位为0应该是因为这光驱中无光盘。/*此处错误，0对应的是I盘，时间久远，估计是因为但是U盘被拔掉了。H盘位置对应的确实是1*/

 

GetLogicalDriveStrings

       这个函数还挺有意思的，可以用于获取目前系统上所有的盘符，有趣就在于其字符串的排列方式。函数原型如下：

 

DWORD GetLogicalDriveStrings(  DWORD nBufferLength,  // size of buffer

                                                      LPTSTRlpBuffer       // drive strings buffer);

       然后看下函数调用后其在缓冲区参数的结果：

 

       很有趣吧，哈哈，反正我是第一次见到。

       然后下面展示下这个字符串是如何结束的：

 

       最后面连续的两个0值表明字符串都已结束。好玩的很。

 

FindFirstVolume

       这个函数能获取计算机上的第一个卷，并且返回一个句柄，用于FindNextVolume函数的使用。函数原型如下：

HANDLE FindFirstVolume(  LPTSTR lpszVolumeName,   // output buffer

DWORD cchBufferLength    // size of output buffer);

演示结果：

      

这个函数我在使用的时候还遇到了一点小小的麻烦，就是最初我设置缓冲区大小为32，结果，返回了一个无效句柄……后来改的256，才正常工作了。

 

FindNextVolume

       这个函数时要配合着上面函数返回的句柄使用的函数，函数原型如下：

       BOOLFindNextVolume(  HANDLE hFindVolume,      // volume search handle

            LPTSTR lpszVolumeName,   // output buffer

            DWORD cchBufferLength    // size of output buffer);

贴下运行截图：

 

在这里你可能要问，上面这一串数据都是什么，我的回答：我也不知道。

FindVolumeClose

这个函数的作用就是单纯的关闭上面那个查找句柄的。不多说了。

GetDriveType

这个函数的作用是根据盘符来确定驱动器的类型。且看函数原型如下：

UINTGetDriveType(  LPCTSTRlpRootPathName   // root directory);

       这里参数是就是路径名，当然了，只有一个盘符，如CDEF，这个参数可以通过上面的一个函数GetLogicalDriveString的结果来使用。返回值就是驱动器类型了。类型表如下：

 

我写了个专用函数，如下：

 1 //仅?限T单Ì£¤线?程¨¬使º1用®?
 2 
 3 LPCTSTR GetTypeString(LPCTSTR lpDriverRoot)
 4 
 5 {
 6 
 7      static LPCTSTR Buf[7] = \
 8 
 9      {
10 
11          _T("UNKNOWN"),
12 
13          _T("NO_ROOT_DIR"),
14 
15          _T("REMOVABLE"),
16 
17          _T("FIXED"),
18 
19          _T("REMOTE"),
20 
21          _T("CDROM"),
22 
23          _T("RAMDISK"),
24 
25      };
26 
27      int nAddr = -1;
28 
29      switch(GetDriveType(lpDriverRoot))
30 
31      {
32 
33      case DRIVE_UNKNOWN:
34 
35          nAddr = 0;
36 
37          break;
38 
39      case DRIVE_NO_ROOT_DIR:
40 
41          nAddr = 1;
42 
43          break;
44 
45      case DRIVE_REMOVABLE:
46 
47          nAddr = 2;
48 
49          break;
50 
51      case DRIVE_FIXED:
52 
53          nAddr = 3;
54 
55          break;
56 
57      case DRIVE_REMOTE:
58 
59          nAddr = 4;
60 
61          break;
62 
63      case DRIVE_CDROM:
64 
65          nAddr = 5;
66 
67          break;
68 
69      case DRIVE_RAMDISK:
70 
71          nAddr = 6;
72 
73          break;
74 
75      default:
76 
77          return NULL;
78 
79      }
80 
81      return Buf[nAddr];
82 
83 }

 

运行结果：

 

这里截图只有一部分，显示了磁盘和光盘的区别。

GetVolumeInformation

       这个函数还是比较复杂的，无他，参数太多了，且看函数原型：

BOOL GetVolumeInformation(  LPCTSTR lpRootPathName,           // root directory

  LPTSTR lpVolumeNameBuffer,        // volume name buffer

  DWORD nVolumeNameSize,            // length of name buffer

  LPDWORD lpVolumeSerialNumber,     // volume serial number

  LPDWORD lpMaximumComponentLength, // maximum file name length

  LPDWORD lpFileSystemFlags,        // file system options

  LPTSTR lpFileSystemNameBuffer,    // file system name buffer

  DWORD nFileSystemNameSize         // length of file system name buffer);

一共8个参数，真要命。

这个函数的作用是用来获取指定路径的文件系统以及卷信息q其中有五个参数都是输出型参数。下面看下两个NameBuffer都返回的是什么。

 

　　这里看到lpVolumeNameBuffer参数返回的是驱动器的名字，这里系统盘是win7，而其他盘因为未命名所以什么也没有。

       lpFileSystemNameBuffer参数则是用于返回文件系统类型。这里能看到，硬盘的文件系统是NTFS。后面因为我的笔记本中插着U盘，所以其 显示结果是FAT32.

       而lpVolumeSerialNumber参数返回的是序列号，这个参数具体的用处我也不是很清楚。

       lpMaximumComponentLength参数返回的是文件系统支持的文件名最大长度。255还是很大的。

       lpFileSystemFlags文件系统选项的标志位，还是所谓的文图返回吧。这个参数有个专门的列表：

 

这种表就属于那种一看就头大的表，还是写个函数看一下比较靠谱。

 

函数实现：

 1 void CheckFileSystemFlag(DWORD FSF)
 2 {
 3     //我是不是应该用个结构体做？
 4     static LPCTSTR lpList[12] = 
 5     {
 6         _T("The file system preserves the case of file names when it places a name on disk."),
 7         _T("The file system supports case-sensitive file names."),
 8         _T("The file system supports Unicode in file names as they appear on disk."),
 9         _T("The file system preserves and enforces ACLs. For example, NTFS preserves and enforces ACLs, and FAT does not."),
10         _T("The file system supports file-based compression."),
11         _T("The specified volume is a compressed volume; for example, a DoubleSpace volume."),
12         _T("The file system supports named streams."),
13         _T("The file system supports the Encrypted File System (EFS)."),
14         _T("The file system supports object identifiers."),
15         _T("The file system supports reparse points."),
16         _T("The file system supports sparse files."),
17         _T("The file system supports disk quotas.")
18     };
19     static const DWORD FlagList[12] = 
20     {
21         FS_CASE_IS_PRESERVED,
22         FS_CASE_SENSITIVE,
23         FS_UNICODE_STORED_ON_DISK,
24         FS_PERSISTENT_ACLS,
25         FS_FILE_COMPRESSION,
26         FS_VOL_IS_COMPRESSED,
27         FILE_NAMED_STREAMS,
28         FILE_SUPPORTS_ENCRYPTION,
29         FILE_SUPPORTS_OBJECT_IDS,
30         FILE_SUPPORTS_REPARSE_POINTS,
31         FILE_SUPPORTS_SPARSE_FILES,
32         FILE_VOLUME_QUOTAS
33     };
34     for(int i = 0;i < 12;++ i)
35     {
36         if(FSF & FlagList[i])
37             wcout << lpList[i] << endl;
38     }
39 }

可以对照一下结果，能发现，NTFS仅仅没有压缩卷这一项。而FAT32则只有两个结果。文件系统的差别还是挺大的。

FindFirstVolumeMountPoint

       这个函数的原型如下：

HANDLE FindFirstVolumeMountPoint(  LPTSTR lpszRootPathName,     // volume name

  LPTSTR lpszVolumeMountPoint, // output buffer

  DWORD cchBufferLength        // size of output buffer);

这里第一个参数是使用FindFirstVolume的的volume字符串，也就是很长的那一串。但是在我的计算机上，这个函数的返回值始终都是失败，而且现在也没理解所谓的挂载是什么意思。这几个函数暂且搁置。

GetDiskFreeSpace

这个函数是用来获取磁盘信息的。函数原型如下：

BOOL GetDiskFreeSpace(  LPCTSTR lpRootPathName,          // root path

  LPDWORD lpSectorsPerCluster,     // sectors per cluster

  LPDWORD lpBytesPerSector,        // bytes per sector

  LPDWORD lpNumberOfFreeClusters,  // free clusters

  LPDWORD lpTotalNumberOfClusters  // total clusters);

       第一个参数就是路径名，比如C:\。演示下运行结果：

 

这个函数没大多好说的，看了就会用。