StrFormatByteSize64A-Funktion (shlwapi.h)
Konvertiert einen numerischen Wert in eine Zeichenfolge, die die Zahl darstellt, die je nach Größe als Größenwert in Bytes, Kilobyte, Megabyte oder Gigabyte ausgedrückt wird.
Syntax
PSTR StrFormatByteSize64A(
LONGLONG qdw,
[out] PSTR pszBuf,
UINT cchBuf
);
Parameter
qdw
Typ: LONGLONG
Der zu konvertierende numerische Wert.
[out] pszBuf
Typ: PSTR
Ein Zeiger auf einen Puffer, der die konvertierte Zahl empfängt, wenn diese Funktion erfolgreich zurückgibt.
cchBuf
Typ: UINT
Die Größe des Puffers, auf den pszBuf in Zeichen verweist.
Rückgabewert
Typ: PSTR
Gibt einen Zeiger auf die konvertierte Zeichenfolge oder NULL zurück, wenn die Konvertierung fehlschlägt.
Hinweise
StrFormatByteSize64 kann entweder für ANSI- oder Unicode-Zeichen verwendet werden. StrFormatByteSize64A kann zwar direkt aufgerufen werden, StrFormatByteSize64W ist jedoch nicht definiert. Wenn StrFormatByteSize64 mit einem Unicode-Wert aufgerufen wird, wird StrFormatByteSizeW verwendet.
In Windows 10 wird die Größe in Basis 10 und nicht in Basis 2 gemeldet. Beispielsweise sind 1 KB 1000 Bytes statt 1024.
Die folgende Tabelle veranschaulicht, wie diese Funktion einen numerischen Wert in eine Textzeichenfolge konvertiert.
| Numerischer Wert | Textzeichenfolge |
|---|---|
| 532 | 532 Bytes |
| 1340 | 1,30 KB |
| 23506 | 23,5 KB |
| 2400016 | 2,40 MB |
| 2400000000 | 2,4 GB |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlwapi.h |
| Bibliothek | Shlwapi.lib |
| DLL | Shlwapi.dll (Version 5.0 oder höher) |