StrFormatKBSizeW-Funktion (shlwapi.h)
Wandelt einen numerischen Wert in eine Zeichenfolge um, die die als Größenwert in Kilobyte ausgedrückte Zahl darstellt.
Syntax
PWSTR StrFormatKBSizeW(
LONGLONG qdw,
[out] PWSTR 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) |