Функция StrFormatKBSizeW (shlwapi.h)

Статья
11/20/2024

Преобразует числовое значение в строку, представляющую число, выраженное как значение размера в килобайтах.

Синтаксис

PWSTR StrFormatKBSizeW(
        LONGLONG qdw,
  [out] PWSTR    pszBuf,
        UINT     cchBuf
);

Параметры

qdw

Тип: LONGLONG

Числовое значение, которое необходимо преобразовать.

[out] pszBuf

Тип: PTSTR

Указатель на буфер, который, когда эта функция возвращается успешно, получает преобразованное число.

cchBuf

Тип: UINT

Размер pszBufв символах.

Возвращаемое значение

Тип: PTSTR

Возвращает указатель на преобразованную строку или NULL, если преобразование завершается ошибкой.

Замечания

В Windows 10 размер отображается в базе 10, а не в базовой версии 2. Например, 1 КБ составляет 1000 байт, а не 1024.

Заметка

Заголовок shlwapi.h определяет StrFormatKBSize как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

См. также

StrFormatByteSizeA

StrFormatByteSizeW

Поделиться через