Fungsi StrFormatByteSize64A (shlwapi.h)
Mengonversi nilai numerik menjadi string yang mewakili angka yang dinyatakan sebagai nilai ukuran dalam byte, kilobyte, megabyte, atau gigabyte, tergantung pada ukurannya.
Sintaks
PSTR StrFormatByteSize64A(
LONGLONG qdw,
[out] PSTR pszBuf,
UINT cchBuf
);
Parameter
qdw
Jenis: LONGLONG
Nilai numerik yang akan dikonversi.
[out] pszBuf
Jenis: PSTR
Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, menerima angka yang dikonversi.
cchBuf
Jenis: UINT
Ukuran buffer yang diacu oleh pszBuf, dalam karakter.
Menampilkan nilai
Jenis: PSTR
Mengembalikan penunjuk ke string yang dikonversi, atau NULL jika konversi gagal.
Keterangan
StrFormatByteSize64 dapat digunakan untuk karakter ANSI atau Unicode. Namun, sementara StrFormatByteSize64A dapat dipanggil secara langsung, StrFormatByteSize64W tidak ditentukan. Ketika StrFormatByteSize64 dipanggil dengan nilai Unicode, StrFormatByteSizeW digunakan.
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 | 23,5 KB |
| 2400016 | 2,40 MB |
| 2400000000 | 2,4 GB |
Persyaratan
| 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 5.0 atau yang lebih baru) |