Fungsi StrFormatByteSizeW (shlwapi.h)
Mengonversi nilai numerik menjadi string yang mewakili angka yang dinyatakan sebagai nilai ukuran dalam byte, kilobyte, megabyte, atau gigabyte, tergantung pada ukurannya. Berbeda dari StrFormatByteSizeA dalam satu jenis parameter.
Sintaks
PWSTR StrFormatByteSizeW(
LONGLONG qdw,
[out] PWSTR pszBuf,
UINT cchBuf
);
Parameter
qdw
Jenis: LONGLONG
Nilai numerik yang akan dikonversi.
[out] pszBuf
Jenis: PWSTR
Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, menerima angka yang dikonversi.
cchBuf
Jenis: UINT
Ukuran buffer yang diacu oleh pszBuf, dalam karakter.
Nilai kembali
Jenis: PWSTR
Mengembalikan penunjuk ke string yang dikonversi, atau NULL jika konversi gagal.
Keterangan
Parameter pertama dari fungsi ini memiliki jenis yang berbeda untuk versi ANSI dan Unicode. Jika nilai numerik Anda adalah DWORD, Anda bisa menggunakan StrFormatByteSize dengan makro teks untuk kedua kasus. Pengkompilasi akan melemparkan nilai numerik ke LONGLONG untuk kasus Unicode. Jika nilai numerik Anda adalah LONGLONG, Anda harus menggunakan StrFormatByteSizeW secara eksplisit.
Dalam Windows 10, ukuran dilaporkan dalam basis 10 daripada basis 2. Misalnya, 1 KB adalah 1000 byte daripada 1024.
Tabel berikut ini menggambarkan bagaimana fungsi ini mengonversi nilai numerik menjadi string teks.
| Nilai numerik | String teks |
|---|---|
| 532 | 532 byte |
| 1340 | 1,30 KB |
| 23506 | 22,9 KB |
| 2400016 | 2,28 MB |
| 2400000000 | 2,23 GB |
Catatan
Header shlwapi.h mendefinisikan StrFormatByteSize 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 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlwapi.h |
| Pustaka | Shlwapi.lib |
| DLL | Shlwapi.dll (versi 4.71 atau yang lebih baru) |