Функция 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 или более поздняя) |