StrFormatKBSizeA-Funktion (shlwapi.h)

Wandelt einen numerischen Wert in eine Zeichenfolge um, die die als Größenwert in Kilobyte ausgedrückte Zahl darstellt.

Syntax

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

Parameter

qdw

Typ: LONGLONG-

Der zu konvertierende numerische Wert.

[out] pszBuf

Typ: PTSTR-

Ein Zeiger auf einen Puffer, der, wenn diese Funktion erfolgreich zurückgegeben wird, die konvertierte Zahl empfängt.

cchBuf

Typ: UINT-

Die Größe pszBufin Zeichen.

Rückgabewert

Typ: PTSTR-

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

Bemerkungen

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

Anmerkung

Der Header "shlwapi.h" 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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Siehe auch

StrFormatByteSizeA-

StrFormatByteSizeW-