StrFormatByteSizeW-Funktion (shlwapi.h)
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für