GetDiskFreeSpace

【勇芳软件工作室】汉化HomePreviousNext

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的卷。

也可以看看

GetDiskFreeSpaceEx, GetDriveType