StrFormatByteSizeEx-Funktion (shlwapi.h)
Konvertiert einen numerischen Wert in eine Zeichenfolge, die je nach Größe die Anzahl in Bytes, Kilobytes, Megabytes oder Gigabyte darstellt. Erweitert StrFormatByteSizeW , indem sie die Option anbietet, auf die nächstgelegene angezeigte Ziffer zu runden oder nicht angezeigte Ziffern zu verwerfen.
Syntax
LWSTDAPI StrFormatByteSizeEx(
ULONGLONG ull,
SFBS_FLAGS flags,
[out] PWSTR pszBuf,
UINT cchBuf
);
Parameter
ull
Typ: ULONGLONG
Der numerische Wert, der konvertiert werden soll.
flags
Typ: SFBS_FLAGS
Einer der SFBS_FLAGS Enumerationswerte, der angibt, ob nicht angezeigte Ziffern gerundet oder abgeschnitten werden sollen. Dieser Wert darf nicht NULL sein.
[out] pszBuf
Typ: PWSTR
Ein Zeiger auf einen Puffer, der die konvertierte Zeichenfolge empfängt.
cchBuf
Typ: UINT
Die Größe des Puffers, auf den pszBuf in Zeichen verweist.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die folgende Tabelle veranschaulicht, wie diese Funktion einen numerischen Wert in eine Textzeichenfolge in Bezug auf das übergebene Flag konvertiert.
| Numerischer Wert | Flag | Textzeichenfolge |
|---|---|---|
| 2147483647 | SFBS_FLAGS_ROUND_TO_NEAREST_DISPLAYED_DIGIT | 2,00 GB |
| 2147483647 | SFBS_FLAGS_TRUNCATE_UNDISPLAYED_DECIMAL_DIGITS | 1,99 GB |
In Windows 10 wird die Größe in Basis 10 und nicht in Basis 2 gemeldet. Beispielsweise ist 1 KB 1000 Bytes statt 1024.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista mit SP1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlwapi.h |
| Bibliothek | Shlwapi.lib |
| DLL | Shlwapi.dll (Version 6.0 oder höher) |