windows磁盘API实践

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……

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

DWORD
GetLogicalDrives(VOID);

代码运行结果：



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

GetLogicalDriveStrings

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

DWORD GetLogicalDriveStrings( DWORD nBufferLength, // size of buffer

LPTSTR
lpBuffer // drive strings buffer);

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



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

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



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

FindFirstVolume

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

HANDLE FindFirstVolume( LPTSTR lpszVolumeName, // output buffer

DWORD cchBufferLength // size of output buffer);

演示结果：



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

FindNextVolume

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

BOOL
FindNextVolume( HANDLE hFindVolume, // volume search handle

LPTSTR lpszVolumeName, // output buffer

DWORD cchBufferLength // size of output buffer);

贴下运行截图：



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

FindVolumeClose

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

GetDriveType

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

UINT
GetDriveType( LPCTSTR
lpRootPathName // root directory);

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



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

//仅?限T单Ì£¤线?程¨¬使º1用®?

LPCTSTR GetTypeString(LPCTSTR lpDriverRoot)

{

static LPCTSTR Buf[7] = \

{

_T("UNKNOWN"),

_T("NO_ROOT_DIR"),

_T("REMOVABLE"),

_T("FIXED"),

_T("REMOTE"),

_T("CDROM"),

_T("RAMDISK"),

};

int nAddr = -1;

switch(GetDriveType(lpDriverRoot))

{

case DRIVE_UNKNOWN:

nAddr = 0;

break;

case DRIVE_NO_ROOT_DIR:

nAddr = 1;

break;

case DRIVE_REMOVABLE:

nAddr = 2;

break;

case DRIVE_FIXED:

nAddr = 3;

break;

case DRIVE_REMOTE:

nAddr = 4;

break;

case DRIVE_CDROM:

nAddr = 5;

break;

case DRIVE_RAMDISK:

nAddr = 6;

break;

default:

return NULL;

}

return Buf[nAddr];

}

运行结果：



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

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文件系统选项的标志位，还是所谓的文图返回吧。这个参数有个专门的列表：

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



函数实现：

void CheckFileSystemFlag(DWORD FSF)
{
//我是不是应该用个结构体做？
static LPCTSTR lpList[12] =
{
_T("The file system preserves the case of file names when it places a name on disk."),
_T("The file system supports case-sensitive file names."),
_T("The file system supports Unicode in file names as they appear on disk."),
_T("The file system preserves and enforces ACLs. For example, NTFS preserves and enforces ACLs, and FAT does not."),
_T("The file system supports file-based compression."),
_T("The specified volume is a compressed volume; for example, a DoubleSpace volume."),
_T("The file system supports named streams."),
_T("The file system supports the Encrypted File System (EFS)."),
_T("The file system supports object identifiers."),
_T("The file system supports reparse points."),
_T("The file system supports sparse files."),
_T("The file system supports disk quotas.")
};
static const DWORD FlagList[12] =
{
FS_CASE_IS_PRESERVED,
FS_CASE_SENSITIVE,
FS_UNICODE_STORED_ON_DISK,
FS_PERSISTENT_ACLS,
FS_FILE_COMPRESSION,
FS_VOL_IS_COMPRESSED,
FILE_NAMED_STREAMS,
FILE_SUPPORTS_ENCRYPTION,
FILE_SUPPORTS_OBJECT_IDS,
FILE_SUPPORTS_REPARSE_POINTS,
FILE_SUPPORTS_SPARSE_FILES,
FILE_VOLUME_QUOTAS
};
for(int i = 0;i < 12;++ i)
{
if(FSF & FlagList[i])
wcout << lpList[i] << endl;
}
}

可以对照一下结果，能发现，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:\。演示下运行结果：



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