GetDiskFreeSpace 和 GetDiskFreeSpaceEx

文章目录

GetDiskFreeSpace
函数声明
函数功能
第一个参数：
第二个参数：
第三个参数：
第四个参数：
第五个参数：
返回值
补充
代码实现
GetDiskFreeSpaceEx
函数声明
函数功能
第一个参数
第二个参数
第三个参数
第四个参数
返回值
代码实现
补充：

GetDiskFreeSpace

函数声明

BOOL GetDiskFreeSpace(LPCTSTR lpRootPathName, //rootpathLPDWORD lpSectorsPerCluster, //sectorsperclusterLPDWORD lpBytesPerSector ,//bytespersectorLPDWORD lpNumberOfFreeClusters, //freeclustersLPDWORD lpTotalNumberOfClusters //totalclusters);

函数功能

获取与一个磁盘的组织有关的信息，以及了解剩余空间的容量。该函数是获取指定磁盘的信息(包括剩余空间的信息)，函数不能获取到卷的大小超过2GB的磁盘的信息,如果要获得可以使用GetDiskFreeSpaceEx函数;来实现

第一个参数：

pRootPathName输入参数，磁盘的根目录,如果设置为空,函数就使用当前目录作为这个参数传入,如果指定的是一个UNC名的话,文件名的最后必须带上一个反斜杠

第二个参数：

lpSectorsPerCluster,输出参数，指定每个簇的扇区数目

第三个参数：

lpBytesPerSector输出参数，指定每个扇区的字节数目

第四个参数：

lpNumberOfFreeClusters输出参数，磁盘总的空闲簇数目

第五个参数：

lpTotalNumberOfClusters 输出参数，磁盘总的簇数目

返回值

调用成功将返回一个非0值

调用不成功返回0 可以通过GetLastError来获得错误信息

补充

簇 - 文件系统用来管理文件数据的最小单位。

每一个簇都是由连续的几个扇区组成，例如

通常是由1/2/4/8/16… 扇区组成。

FAT16/32 - 4K、8K

NTFS - 4K

全部空间(TotalLetfSize) = 总簇数量 * 每簇的扇区数 * 每扇区字节数。
剩余空间(TotalLetfSize) = 空余簇数量 * 每簇的扇区数 * 每扇区字节数。

代码实现

 BOOL bResult;DWORD dwTotalClusters;DWORD dwFreeClusters;DWORD dwSectPerClust;DWORD dwbytesPerSect;bResult = GetDiskFreeSpace(TEXT("c:"), &dwSectPerClust, &dwbytesPerSect, &dwFreeClusters, &dwTotalClusters);if (bResult) {printf("\n使用 GetDiskFreeSpace获取磁盘空间信息\n");printf("总簇数量：\t\t\t%I64d\n",dwTotalClusters);printf("空闲的簇数量：\t\t\t%I64d\n", dwFreeClusters);printf("每簇的扇区数量：\t\t\t%I64d\n", dwSectPerClust);printf("每扇区的字节数：\t\t\t%I64d\n", dwbytesPerSect);printf("磁盘总容量：\t\t\t%I64d\n", (DWORD64)dwTotalClusters* (DWORD64)dwSectPerClust* (DWORD64)dwbytesPerSect);printf("磁盘空闲容量：\t\t\t%I64d\n", (DWORD64)dwFreeClusters * (DWORD64)dwSectPerClust * (DWORD64)dwbytesPerSect);}

GetDiskFreeSpaceEx

GetDiskFreeSpaceEx(TEXT("c:"),(PULARGE_INTEGER)&qwFreeBytesTocaller,(PULARGE_INTEGER)&qwTotalBytes,(PULARGE_INTEGER)&qwFreeBytes);

函数声明

BOOL GetDiskFreeSpaceEx( LPCWSTR lpDirectoryName, PULARGE_INTEGER lpFreeBytesAvailableToCaller, PULARGE_INTEGER lpTotalNumberOfBytes, PULARGE_INTEGER lpTotalNumberOfFreeBytes
);

函数功能

可以得到驱动器的簇信息，剩余空间以及总大小。

第一个参数

lpDirectoryName，输入参数，磁盘的根目录,如果设置为空,函数就使用当前目录作为这个参数传入,如果指定的是一个UNC名的话,文件名的最后必须带上一个反斜杠

第二个参数

lpFreeBytesAvailableToCaller指定一个变量，用于容纳 调用者可用的字节数量

第三个参数

lpTotalNumberOfBytes指定一个变量，用于容纳磁盘上的总字节数

第四个参数

lpTotalNumberOfFreeBytes指定一个变量，用于容纳磁盘上可用的字节数

返回值

Long，非零表示成功，零表示失败。会设置GetLastError

代码实现

DWORD64 qwFreeBytes, qwFreeBytesTocaller, qwTotalBytes;bResult = GetDiskFreeSpaceEx(TEXT("c:"),(PULARGE_INTEGER)&qwFreeBytesTocaller,(PULARGE_INTEGER)&qwTotalBytes,(PULARGE_INTEGER)&qwFreeBytes);if (bResult) {printf("\n使用GetDiskFreeSpaceEx获取磁盘空间信息\n");printf("磁盘总容量：\t\t\t%I64d\n",qwTotalBytes );printf("可用的磁盘空闲容量：\t\t\t%I64d\n",qwFreeBytes );printf("磁盘空闲容量：\t\t\t%I64d\n", qwFreeBytesTocaller);}

把两个函数一起运行一下，看看是否数据相等：

查看了一下，完全一样，到这里呢，game over！！

补充：

讲一下PULARGE_INTEGER。我们这个函数得到的信息是磁盘的总大小、当前用户可操作大小、剩余磁盘空间，单位是字节。但是在我的电脑上int 以及 long int都是4个字节，也就是最大(无符号)能存是数2³²字节,等于4G左右，显然已经不够了，现在随意一个分区就是几百G。所以这个函数用了一个特别的方法，即用一个联合，里面保存着一个结构体，而结构体里面有两个32位的整数，分别表示该数的上半部分和下半部分。于是就可以表示出一个64位的整数了。

typedef union _ULARGE_INTEGER {struct {DWORD LowPart;DWORD HighPart;} u;ULONGLONG QuadPart;
} ULARGE_INTEGER, *PULARGE_INTEGER;

PULARGE_INTEGER其实指向的是这个联合，这个联合中的结构体中的LowPart表示低32位,HighPart表示高32位。

不过输出得到的是一大串数字(因为是以字节为单位)，如果我们想以MB或GB为单位怎么办呢？直接拿TotalNumberOfBytes/1024/1024，发现编译会报错。你拿一个联合去和一个整数做除法运算，肯定报错。

int Total = (TotalNumberOfBytes.u.HighPart << 12) + (TotalNumberOfBytes.u.LowPart >> 20);

将高32位向左移12位，将低32位向右移20位，再相加，目的是什么？先看将LowPart向右移20位，剩下的其实就是LowPart的左12位。因为我们要得到以MB为单位，而1MB是2^20字节，所以只保留LowPart的左12位。而HighPart的所有位都应该保留，所以要放在第13位以后，故HighPart左移12位，最后相加

最后Total再想转换成GB就除以1024.0就可以。

注意： LARGE_INTEGER结构与FILETIME结构在内部完全一致。正式调用前，用GetVersionEx判断函数是否得到了支持。在Windows 95 OSR2环境中，OSVERSIONINFO结构的dwBuildNumbe字段会大于1000

备注：
2021年坚持学写博客第9天（学习两个windows API）寻梦SS

明日目标：
windows核心编程API函数