StrFormatByteSizeW-Funktion (shlwapi.h)

  • Artikel

Konvertiert einen numerischen Wert in eine Zeichenfolge, die die als Größenwert ausgedrückte Zahl je nach Größe in Bytes, Kilobytes, Megabytes oder Gigabyte darstellt. Unterscheidet sich von StrFormatByteSizeA in einem Parametertyp.

Syntax

PWSTR StrFormatByteSizeW(
        LONGLONG qdw,
  [out] PWSTR    pszBuf,
        UINT     cchBuf
);

Parameter

qdw

Typ: LONGLONG

Der numerische Wert, der konvertiert werden soll.

[out] pszBuf

Typ: PWSTR

Ein Zeiger auf einen Puffer, der bei erfolgreicher Rückgabe dieser Funktion die konvertierte Zahl empfängt.

cchBuf

Typ: UINT

Die Größe des Puffers, auf den pszBuf in Zeichen verweist.

Rückgabewert

Typ: PWSTR

Gibt einen Zeiger auf die konvertierte Zeichenfolge oder NULL zurück, wenn die Konvertierung fehlschlägt.

Hinweise

Der erste Parameter dieser Funktion weist unterschiedliche Typen für die ANSI- und Unicode-Versionen auf. Wenn Ihr numerischer Wert ein DWORD ist, können Sie StrFormatByteSize mit Textmakros für beide Fälle verwenden. Der Compiler wandelt den numerischen Wert für den Unicode-Fall in einen LONGLONG-Wert um. Wenn Ihr numerischer Wert ein LONGLONG-Wert ist, sollten Sie StrFormatByteSizeW explizit verwenden.

In Windows 10 wird die Größe in Basis 10 und nicht in Basis 2 gemeldet. Beispielsweise ist 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 22,9 KB
2400016 2,28 MB
2400000000 2,23 GB
 

Hinweis

Der shlwapi.h-Header definiert StrFormatByteSize als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
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 4.71 oder höher)

Weitere Informationen

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeEx