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)

Weitere Informationen

StrFormatByteSizeA

StrFormatByteSizeW