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

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

Синтаксис

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

Параметры

qdw

Тип: LONGLONG

Числовое значение для преобразования.

[out] pszBuf

Тип: PWSTR

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

cchBuf

Тип: UINT

Размер буфера, на который указывает pszBuf, в символах.

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

Тип: PWSTR

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

Комментарии

Первый параметр этой функции имеет различные типы для версий ANSI и Юникода. Если числовое значение является DWORD, можно использовать StrFormatByteSize с текстовыми макросами в обоих случаях. Компилятор приведет числовое значение к LONGLONG для варианта Юникода. Если числовое значение — LONGLONG, следует явно использовать StrFormatByteSizeW .

В Windows 10 размер указывается в базе 10, а не в базе 2. Например, 1 КБ — это 1000 байт, а не 1024.

В следующей таблице показано, как эта функция преобразует числовое значение в текстовую строку.

Числовое значение	Текстовая строка
532	532 байта
1340	1,30 КБ
23506	22,9 КБ
2400016	2,28 МБ
2400000000	2,23 ГБ

 

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

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

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeEx