Bagikan melalui

Fungsi SHGetDiskFreeSpaceExW (shellapi.h)

  • Artikel

Mengambil informasi ruang disk untuk volume disk.

Sintaks

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

Parameter

[in] pszDirectoryName

Jenis: LPCTSTR

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

[out, optional] pulFreeBytesAvailableToCaller

Jenis: ULARGE_INTEGER*

Arahkan 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.

Nilai kembali

Jenis: BOOL

Mengembalikan TRUE jika berhasil, FALSE jika tidak.

Keterangan

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

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

Catatan

Header shellapi.h mendefinisikan SHGetDiskFreeSpaceEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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

Lihat juga

GetDiskFreeSpaceEx

SHGetDiskFreeSpace