StrFormatKBSizeA-Funktion (shlwapi.h)

Konvertiert einen numerischen Wert in eine Zeichenfolge, die die Zahl darstellt, die als Größenwert in KB ausgedrückt wird.

Syntax

PSTR StrFormatKBSizeA(
        LONGLONG qdw,
  [out] PSTR     pszBuf,
        UINT     cchBuf
);

Parameter

qdw

Typ: LONGLONG

Der numerische Wert, der konvertiert werden soll.

[out] pszBuf

Typ: PTSTR

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

cchBuf

Typ: UINT

Die Größe von pszBuf in Zeichen.

Rückgabewert

Typ: PTSTR

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

Hinweise

In Windows 10 wird die Größe in Basis 10 und nicht in Basis 2 gemeldet. Beispielsweise ist 1 KB 1000 Bytes statt 1024.

Hinweis

Der shlwapi.h-Header definiert StrFormatKBSize als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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

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