StrFormatByteSizeEx-Funktion (shlwapi.h)

  • Artikel

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)

Weitere Informationen

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeW