Windows API一日一练(62)GetDiskFreeSpaceEx函数

有一次客户给我打来了投诉电话，说我的软件太不好用了，导致他们丢失了很多数据。后来我仔细地查看LOG，分析出来的原因，其实是很简单的，就是磁盘的空间不够了。我给客户说他们的电脑磁盘空间不够了导致出错的问题，但客户反问我为什么不提示磁盘空间不足。是啊，为什么不提示磁盘的空间不足呢？为了解决这个需求，就需要使用到这个函数GetDiskFreeSpaceEx。

函数GetDiskFreeSpaceEx声明如下：

WINBASEAPI

BOOL

WINAPI

GetDiskFreeSpaceExA(

__in_optLPCSTR lpDirectoryName,

__out_opt PULARGE_INTEGER lpFreeBytesAvailableToCaller,

__out_opt PULARGE_INTEGER lpTotalNumberOfBytes,

__out_opt PULARGE_INTEGER lpTotalNumberOfFreeBytes

);

WINBASEAPI

BOOL

WINAPI

GetDiskFreeSpaceExW(

__in_optLPCWSTR lpDirectoryName,

__out_opt PULARGE_INTEGER lpFreeBytesAvailableToCaller,

__out_opt PULARGE_INTEGER lpTotalNumberOfBytes,

__out_opt PULARGE_INTEGER lpTotalNumberOfFreeBytes

);

#ifdef UNICODE

#define GetDiskFreeSpaceExGetDiskFreeSpaceExW

#else

#define GetDiskFreeSpaceExGetDiskFreeSpaceExA

#endif // !UNICODE

lpDirectoryName是驱动器的名称。

lpFreeBytesAvailableToCaller是用户可用的磁盘空间。

lpTotalNumberOfBytes是磁盘总共的空间。

lpTotalNumberOfFreeBytes是磁盘空闲的空间。以上都是字节为单位。

调用函数的例子如下：

#001//获取磁盘剩余空间。

#002//蔡军生2007/11/01 QQ:9073204 深圳

#003void DiskFree(void)

#004{

#005 //

#006 ULARGE_INTEGER nFreeBytesAvailable;

#007 ULARGE_INTEGER nTotalNumberOfBytes;

#008 ULARGE_INTEGER nTotalNumberOfFreeBytes;

#009 //

#010 if (GetDiskFreeSpaceEx(_T("C:"),

#011 &nFreeBytesAvailable,

#012 &nTotalNumberOfBytes,

#013 &nTotalNumberOfFreeBytes))

#014 {

#015 TCHAR chBuf[256];

#016 wsprintf(chBuf,_T("Av=%I64d,Total=%I64d,Free=%I64d/r/n"),

#017 nFreeBytesAvailable,

#018 nTotalNumberOfBytes,

#019 nTotalNumberOfFreeBytes);

#020 OutputDebugString(chBuf);

#021 }

#022}