共用方式為

SHGetDiskFreeSpaceExA 函式 （shellapi.h）

  • 發行項

擷取磁碟區磁碟空間資訊。

語法

BOOL SHGetDiskFreeSpaceExA(
  [in]            LPCSTR         pszDirectoryName,
  [out, optional] ULARGE_INTEGER *pulFreeBytesAvailableToCaller,
  [out, optional] ULARGE_INTEGER *pulTotalNumberOfBytes,
  [out, optional] ULARGE_INTEGER *pulTotalNumberOfFreeBytes
);

參數

[in] pszDirectoryName

類型：LPCTSTR

以 Null 結束的字串，指定擷取大小資訊的磁碟區。 這可以是驅動器號、UNC 名稱或資料夾的路徑。 您無法使用 NULL 來表示目前的磁碟驅動器。

[out, optional] pulFreeBytesAvailableToCaller

類型：ULARGE_INTEGER*

值指標，這個值會接收呼叫端應用程式可用之磁碟區上的位元元組數目。 如果操作系統實作每個使用者配額，這個值可能小於磁碟區上可用位元組總數。

[out, optional] pulTotalNumberOfBytes

類型：ULARGE_INTEGER*

接收磁碟區大小總計的值指標，以位元組為單位。

[out, optional] pulTotalNumberOfFreeBytes

類型：ULARGE_INTEGER*

值指標，這個值會接收磁碟區上可用空間的位元元組數目。

傳回值

類型：BOOL

如果成功，則會傳回 true TRUE ，否則傳回 FALSE。

言論

類似命名的函式 SHGetDiskFreeSpace 只是 SHGetDiskFreeSpaceEx別名。 當您呼叫 SHGetDiskFreeSpace 您實際呼叫此函式時。

如果操作系統有可用的函式，此函式會呼叫 GetDiskFreeSpaceEx 函式。 如果 GetDiskFreeSpaceEx 無法使用，則會藉由 呼叫 getDiskFreeSpace 函式和操作傳回值來模擬它。 如需詳細資訊，請參閱 getDiskFreeSpaceEx檔。

注意

Shellapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SHGetDiskFreeSpaceEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shellapi.h
連結庫 Shell32.lib
DLL Shell32.dll 版 （5.0 版或更新版本）

另請參閱

GetDiskFreeSpaceEx

SHGetDiskFreeSpace