GetDiskFreeSpace函数检索有关指定磁盘的信息,包括磁盘上的可用空间量。
BOOL GetDiskFreeSpace(
LPCTSTR 【lpRootPathName】, | //根路径的地址 |
LPDWORD 【lpSectorsPerCluster】, | //每个群集扇区的地址 |
LPDWORD 【lpBytesPerSector】, | //每个扇区的字节地址 |
LPDWORD 【lpNumberOfFreeClusters】, | //自由集群数的地址 |
LPDWORD 【lpTotalNumberOfClusters】 | //集群总数的地址 |
); |
参数
【lpRootPathName】
指向一个以null结尾的字符串,指定磁盘的根目录以返回有关的信息。如果【lpRootPathName】为NULL,则该函数使用当前目录的根。
【lpSectorsPerCluster】
指向每个群集扇区数的变量。
【lpBytesPerSector】
指向每个扇区的字节数的变量。
【lpNumberOfFreeClusters】
指向磁盘上可用集群总数的变量。
【lpTotalNumberOfClusters】
指向磁盘上集群总数的变量。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
Windows 95:
对于大于2 GB的卷,GetDiskFreeSpace函数返回不正确的值。该函数将存储在* 【lpNumberOfFreeClusters】和* 【lpTotalNumberOfClusters】中的值覆盖,以避免报告大于2 GB的卷大小。
即使在小于2 GB的卷上,存储为* 【lpSectorsPerCluster】,* 【lpNumberOfFreeClusters】和* 【lpTotalNumberOfClusters】值的值可能不正确。这是因为操作系统操纵这些值,以便与它们的计算产生正确的卷大小。
Windows 95的OSR 2:从OEM Service Release 2(OSR 2)开始,Windows 95系统上提供了GetDiskFreeSpaceEx功能。GetDiskFreeSpaceEx函数返回所有卷的正确值,包括大于2 GB的卷。
也可以看看