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

  • Статья

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

Синтаксис

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 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 5.0 или более поздняя)

См. также раздел

StrFormatByteSizea

StrFormatByteSizeW