Fungsi StrFormatByteSizeEx (shlwapi.h)
Mengonversi nilai numerik menjadi string yang mewakili angka dalam byte, kilobyte, megabyte, atau gigabyte, tergantung pada ukurannya. Memperluas StrFormatByteSizeW dengan menawarkan opsi untuk membulatkan ke digit terdekat yang ditampilkan atau untuk membuang digit yang tidak diputar.
Sintaks
LWSTDAPI StrFormatByteSizeEx(
ULONGLONG ull,
SFBS_FLAGS flags,
[out] PWSTR pszBuf,
UINT cchBuf
);
Parameter
ull
Jenis: ULONGLONG
Nilai numerik yang akan dikonversi.
flags
Jenis: SFBS_FLAGS
Salah satu nilai enumerasi SFBS_FLAGS yang menentukan apakah akan membulatkan atau memotong digit yang tidak diputar. Nilai ini tidak boleh NULL.
[out] pszBuf
Jenis: PWSTR
Penunjuk ke buffer yang menerima string yang dikonversi.
cchBuf
Jenis: UINT
Ukuran buffer yang diacu oleh pszBuf, dalam karakter.
Menampilkan nilai
Jenis: HRESULT
Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Tabel berikut ini menggambarkan bagaimana fungsi ini mengonversi nilai numerik menjadi string teks sehubungan dengan bendera yang diteruskan.
| Nilai numerik | Bendera | String teks |
|---|---|---|
| 2147483647 | SFBS_FLAGS_ROUND_TO_NEAREST_DISPLAYED_DIGIT | 2,00 GB |
| 2147483647 | SFBS_FLAGS_TRUNCATE_UNDISPLAYED_DECIMAL_DIGITS | 1,99 GB |
Dalam Windows 10, ukuran dilaporkan dalam basis 10 daripada basis 2. Misalnya, 1 KB adalah 1000 byte daripada 1024.
Persyaratan
| Klien minimum yang didukung | Windows Vista dengan SP1 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlwapi.h |
| Pustaka | Shlwapi.lib |
| DLL | Shlwapi.dll (versi 6.0 atau yang lebih baru) |