取得位於指定根路徑之磁碟區的磁碟空間資訊。
語法
HRESULT GetDiskSpaceInformationA(
LPCSTR rootPath,
DISK_SPACE_INFORMATION *diskSpaceInfo
);
參數
rootPath
字串的指標，其中包含要查詢之磁碟區的根目錄。
如果此參數為 NULL，函式會使用目前磁碟的根目錄。
diskSpaceInfo
DISK_SPACE_INFORMATION結構，其中包含指定根路徑上磁碟區目前磁碟空間的相關信息。
返回值
S_OK如果函式成功，則傳回 ，如果函式失敗，則傳回來自 Common HRESULT 值的值。 您可以呼叫 GetLastError 以取得擴充錯誤資訊。
備註
rootPath必須是根路徑，例如 C:\ 或 D:\，而不是根路徑的子目錄。
需求
| 要求 | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 10 組建 17763 [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows 10 Server 2019 [傳統型應用程式 |UWP 應用程式] |
| 頁首 | fileapi.h （包括 Windows.h） |
| 程式庫 | kernel32.lib |
| DLL | kernel32.dll |