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

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

 

函数GetDiskFreeSpaceEx声明如下：

 

WINBASEAPI

BOOL

WINAPI

GetDiskFreeSpaceExA(

    __in_opt LPCSTR lpDirectoryName,

    __out_opt PULARGE_INTEGER lpFreeBytesAvailableToCaller,

    __out_opt PULARGE_INTEGER lpTotalNumberOfBytes,

    __out_opt PULARGE_INTEGER lpTotalNumberOfFreeBytes

    );

WINBASEAPI

BOOL

WINAPI

GetDiskFreeSpaceExW(

    __in_opt LPCWSTR lpDirectoryName,

    __out_opt PULARGE_INTEGER lpFreeBytesAvailableToCaller,

    __out_opt PULARGE_INTEGER lpTotalNumberOfBytes,

    __out_opt PULARGE_INTEGER lpTotalNumberOfFreeBytes

    );

#ifdef UNICODE

#define GetDiskFreeSpaceEx GetDiskFreeSpaceExW

#else

#define GetDiskFreeSpaceEx GetDiskFreeSpaceExA

#endif // !UNICODE

 

lpDirectoryName是驱动器的名称。

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

lpTotalNumberOfBytes是磁盘总共的空间。

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

 

调用函数的例子如下：

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

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

#003  void 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  }