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

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

Синтаксис

PSTR StrFormatByteSize64A(
        LONGLONG qdw,
  [out] PSTR     pszBuf,
        UINT     cchBuf
);

Параметры

qdw

Тип: LONGLONG

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

[out] pszBuf

Тип: PSTR

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

cchBuf

Тип: UINT

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

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

Тип: PSTR

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

Комментарии

StrFormatByteSize64 можно использовать для символов ANSI или Юникода. Однако, хотя StrFormatByteSize64A можно вызвать напрямую, StrFormatByteSize64W не определен. При вызове StrFormatByteSize64 со значением Юникода используется StrFormatByteSizeW .

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

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

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

Требования

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

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

StrFormatByteSizea

StrFormatByteSizeW