Fungsi SHGetDiskFreeSpaceExA (shellapi.h)

Mengambil informasi ruang disk untuk volume disk.

Sintaksis

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

Parameter

[in] pszDirectoryName

Jenis: LPCTSTR

String null-terminated yang menentukan volume yang informasi ukurannya diambil. Ini bisa berupa huruf kandar, nama UNC, atau jalur folder. Anda tidak dapat menggunakan NULL untuk mewakili drive saat ini.

[out, optional] pulFreeBytesAvailableToCaller

Jenis: ULARGE_INTEGER*

Penunjuk ke nilai yang menerima jumlah byte pada volume yang tersedia untuk aplikasi panggilan. Jika sistem operasi menerapkan kuota per pengguna, nilai ini mungkin kurang dari jumlah total byte gratis pada volume.

[out, optional] pulTotalNumberOfBytes

Jenis: ULARGE_INTEGER*

Penunjuk ke nilai yang menerima ukuran total volume, dalam byte.

[out, optional] pulTotalNumberOfFreeBytes

Jenis: ULARGE_INTEGER*

Penunjuk ke nilai yang menerima jumlah byte ruang kosong pada volume.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, FALSE sebaliknya.

Komentar

Fungsi bernama serupa SHGetDiskFreeSpace hanyalah alias untuk SHGetDiskFreeSpaceEx. Saat Anda memanggil SHGetDiskFreeSpace Anda benar-benar memanggil fungsi ini.

Fungsi ini memanggil fungsi GetDiskFreeSpaceEx jika tersedia pada sistem operasi. Jika GetDiskFreeSpaceEx tidak tersedia, itu ditiru dengan memanggil fungsi GetDiskFreeSpace dan memanipulasi nilai yang dikembalikan. Untuk informasi tambahan, lihat dokumentasi untuk GetDiskFreeSpaceEx.

Nota

Header shellapi.h mendefinisikan SHGetDiskFreeSpaceEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	shellapi.h
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Lihat juga

GetDiskFreeSpaceEx

SHGetDiskFreeSpace